What You Need To Know First
| Topic | What it means here |
|---|---|
| Transport | Streamable HTTP over POST / |
| Endpoint | https://sports-mcp-server.etonecarg.com/ |
| Auth | Authorization: Bearer <API_KEY> |
| Health check | GET / |
| Core methods | initialize, tools/list, tools/call |
The Three MCP Calls You Will Use Most
| Method | Why it matters |
|---|---|
initialize | starts the session and declares client capabilities |
tools/list | returns the tool catalog your host can call |
tools/call | runs a specific Sports MCP Server tool |
Typical Host Flow
- Add the endpoint and bearer token to your MCP host or backend.
- Send
initialize. - Call
tools/list. - Start with a discovery, resolution, or bundle tool tied to your use case.
Example Host Configuration
Example tools/call Wrapper
Sports MCP Server tool examples in the rest of the docs show the arguments payload. A direct HTTP request wraps those arguments like this:
Response Shape
Tool responses come back through MCP as text content containing JSON. That gives you two practical options:- let your MCP host unwrap and parse the payload for you
- if you call the server directly over HTTP, read the text field and parse the JSON yourself
When To Use Atomic Tools Versus Bundle Tools
| Choose this | When it is the better fit |
|---|---|
| Atomic tools | you want precise control, smaller payloads, or multi-step agent reasoning |
| Bundle tools | you want a product-ready response for dashboards, hubs, match centers, or historical views |
The Most Common Evaluation Pattern
Most teams do not begin with a deep sports object ID already in hand. A strong evaluation usually looks like this:- resolve a fuzzy user phrase with
gns_resolve_entity - fetch current schedule or standings with a discovery or league tool
- graduate to a bundle tool once the product shape is clear
Where To Go Next
- Use Quickstart if you already have a key.
- Use Auth, Quotas, and Errors for production transport rules.
- Use Use Cases if you want to explore the product by experience instead of by tool family.