Machina Sports developer resources
Where to find the Machina Sports API documentation, the OpenAPI specification, authentication, the MCP server, the SDK, and the machine-readable files AI agents use to discover the platform.
Machina Sports API documentation
- docs.machina.gg: product documentation, authoritative for current capabilities, with the API reference.
- worldcup-docs.machina.gg: World Cup Intelligence API documentation (World Cup 2026 showcase).
Machina Sports OpenAPI specification
The World Cup Intelligence APIs are described in OpenAPI 3.1 at /world-cup-api/openapi.json (also served at /openapi.json). Every operation has a unique operationId, a description, and a typed response schema for LLM function calling. The base URL is https://api.machina.gg/world-cup/v1. The API catalog (RFC 9727) links these descriptions to their documentation.
Machina Sports API authentication
- Machina SDK and CLI: an API key in the
X-Api-Tokenheader, scoped to your project. See the SDK overview. - World Cup Intelligence REST APIs: the API key as a Bearer token,
Authorization: Bearer $MACHINA_API_KEY. The World Cup MCP server takes the same key asX-Api-Token.
Machina Sports MCP server
- World Cup Intelligence MCP (developer preview, SSE):
https://worldcup-mcp.org.machina.gg/sse. Server card: /.well-known/mcp/server-card.json. Agent guide: /world-cup-api/agent.txt.
Machina Sports SDK and open source
- The Machina SDK is a REST API on your project's pod, called directly over HTTP with no package to install.
- Open source: Sports Skills and SportsClaw. Agent skills index: /.well-known/agent-skills/index.json.
Machine-readable files
- /llms.txt and /llms-full.txt: site summary and full profile for language models. The homepage also returns this Markdown to clients that send
Accept: text/markdown. - /agent.txt: agent brief. /capabilities.json: capability contract with stated limitations.
