World Cup 2026 Tour
Free MCP server for World Cup 2026 fixtures, local kickoff times, and Dataset JSON-LD.
Open source Open in the app JSON README (API)
About
Free MCP server for World Cup 2026 fixtures, local kickoff times, and Dataset JSON-LD.
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- abaiii168
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Stars
- 1
- Last push
- 2026-06-15T10:24:26Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:22
- Updated
- 2026-08-29 03:02:22
- Origin id
io.github.abaiii168/world-cup-2026
README
# World Cup 2026 MCP Server
Free Model Context Protocol server for the [World Cup 2026 Tour](https://ay-worldcup2026.zeabur.app/) public schedule API.
It lets AI assistants fetch the 2026 FIFA World Cup schedule, next match, one match by id, and the public Dataset JSON-LD without needing an API key.
MCP Registry name: `io.github.abaiii168/world-cup-2026`
## Install
```bash
git clone https://github.com/abaiii168/world-cup-2026-mcp-server.git
cd world-cup-2026-mcp-server
npm install
npm run check
```
## Claude Desktop / MCP Client Config
```json
{
"mcpServers": {
"world-cup-2026": {
"command": "node",
"args": ["/absolute/path/to/world-cup-2026-mcp-server/src/index.js"]
}
}
}
```
## OCI / Registry Metadata
This repo includes `server.json` and a Dockerfile with the required `io.modelcontextprotocol.server.name` annotation for publishing through GitHub Container Registry and the official MCP Registry.
OCI image target:
```text
ghcr.io/abaiii168/world-cup-2026-mcp-server:0.1.0
```
Local Docker smoke check:
```bash
docker build -t world-cup-2026-mcp-server:local .
docker run --rm -i world-cup-2026-mcp-server:local
```
## Tools
- `get_world_cup_2026_metadata` - API metadata, attribution, endpoint links, and schema notes.
- `get_world_cup_2026_matches` - all fixtures in a requested IANA time zone, optionally filtered by stage, group, team, and limit.
- `get_world_cup_2026_next_match` - nearest upcoming fixture in a requested IANA time zone.
- `get_world_cup_2026_match` - one fixture by public match id.
- `get_world_cup_2026_dataset` - Dataset JSON-LD plus all 104 public fixtures in UTC.
## Example Prompts
- "What is the next World Cup 2026 match in London time?"
- "List Mexico's World Cup 2026 group-stage matches in Mexico City time."
- "Give me match 1 with a calendar link."
- "Fetch the World Cup 2026 fixture dataset for citation."
## Data Source
This MCP server wraps the free public endpoints from World Cup 2026 Tour:
- App: https://ay-worldcup2026.zeabur.app/
- API docs: https://ay-worldcup2026.zeabur.app/developers
- Dataset: https://ay-worldcup2026.zeabur.app/dataset
- Dataset JSON-LD: https://ay-worldcup2026.zeabur.app/dataset.json
- OpenAPI: https://ay-worldcup2026.zeabur.app/openapi.json
- Hugging Face AI prediction Space: https://huggingface.co/spaces/abaiii168/world-cup-2026-ai-predictions
Please cache responsibly and link back to the app when using the free data.
## Related AI Prediction Space
This MCP server focuses on factual schedule, calendar, and dataset access. For a public, shareable AI prediction demo surface, use the Hugging Face Space:
- AI prediction Space: https://huggingface.co/spaces/abaiii168/world-cup-2026-ai-predictions
- Tonight's Spain vs Cape Verde AI prediction entry: https://ay-worldcup2026.zeabur.app/?match=14&oracle=1&utm_source=mcp_readme&utm_medium=ai_prediction&utm_campaign=wc26_spain_cape_verde
Helpful agent prompt:
> Use the World Cup 2026 MCP schedule tools to find the next match in my local time, then share the public AI prediction Space for fans who want a playful prediction result.
## Notes
- No API key is required.
- The server uses stdio transport.
- Live scores and betting/odds are intentionally not exposed through this MCP server.
- Set `WC26_API_BASE` only if you are testing a compatible self-hosted API.