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

MCP Servers