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.
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.
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 rowsshootouts.csv
: shootout winners and first shootersgoalscorers.csv
: scorers, penalties, and own goalsformer_names.csv
: historical team-name changes for 36 teams
- 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.
-
Grounded answers from
calypso-rag-agent:worldcup -
Citation-rich responses through the Calypso Responses API
-
Handy resources like
soccer://corpus-info
andsoccer://starter-prompts
- A clean
ask-world-cup-soccer
MCP tool for match-history questions - A read-only demo surface, so agents can explore safely
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
.
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-..."
}
}
}
}
npm install
npm test
npm run smoke:stdio