World Cup Soccer RAG MCP

Ask an AI agent grounded questions about international soccer results, no setup ceremony required. This MCP server boots straight into a Calypso-powered World Cup demo corpus: 150 years of match history, ready for source-backed answers.

Built with Calypso. Learn more in the Calypso docs.

Kickoff

npx -y @calypsohq/soccer-rag-mcp-server

That is it. No API key, no dashboard setup, no copy-pasting secrets. The server connects to the same World Cup RAG corpus as the RAG landing demo.

Inside The Corpus

This is the source-grounded research surface behind the World Cup Results Demo:

• 4 indexed CSV sources
• 49,393 match results from 1872 to 2026
• Results, tournaments, venues, shootouts, goalscorers, and historical team names
• Fast grounded answers by default, with citations from the soccer results corpus
• Read-only demo mode powered by calypso-rag-agent:worldcup

Source trail:

• results.csv: match results and venues, 49,393 rows
• shootouts.csv: shootout winners and first shooters
• goalscorers.csv: scorers, penalties, and own goals
• former_names.csv: historical team-name changes for 36 teams

Try Asking

• Who are the best men's national soccer teams of all time? Rank them using the results corpus and cite your evidence.
• Which national teams dominated each era of international soccer from 1872 to 2026?
• Compare Brazil and Germany across World Cup eras using match results from the corpus.
• How strong is home advantage in international soccer, and has it changed over time?
• Does hosting a major tournament improve a country's performance? Use the corpus to show why or why not.
• What patterns stand out in international penalty shootouts? Use shootouts.csv and cite examples.

What You Get

• Grounded answers from calypso-rag-agent:worldcup
• Citation-rich responses through the Calypso Responses API
• Handy resources like soccer://corpus-info and soccer://starter-prompts
• A clean ask-world-cup-soccer MCP tool for match-history questions
• A read-only demo surface, so agents can explore safely

Claude Desktop Setup

Add this to your Claude Desktop MCP config:

{
  "mcpServers": {
    "world-cup-soccer": {
      "command": "npx",
      "args": ["-y", "@calypsohq/soccer-rag-mcp-server"]
    }
  }
}

Restart Claude Desktop, then ask Claude to use world-cup-soccer for grounded soccer questions. The primary tool is ask-world-cup-soccer.

Bring Your Own Key

Want to use your own Calypso project with upload and bucket tools enabled?

CALYPSO_API_KEY=sk-... npx -y @calypsohq/soccer-rag-mcp-server

BYOK mode switches from the public World Cup demo into your own Calypso knowledge workspace.

For Claude Desktop BYOK mode, add an env block:

{
  "mcpServers": {
    "world-cup-soccer": {
      "command": "npx",
      "args": ["-y", "@calypsohq/soccer-rag-mcp-server"],
      "env": {
        "CALYPSO_API_KEY": "sk-..."
      }
    }
  }
}

Development

npm install
npm test
npm run smoke:stdio