Entertainment

Data source: TheSportsDB (thesportsdb.com)

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/thesportsdb/

nobloat — strip report_feedback tool URL-based auth (for clients without header support)

claude_desktop_config.json

{
  "mcpServers": {
    "gnist-thesportsdb": {
      "url": "https://context.gnist.ai/mcp/thesportsdb/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Shell

curl -X POST "https://context.gnist.ai/mcp/thesportsdb/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_teams", "arguments": {"team_name": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/thesportsdb/

8 endpoints available:

GET /rest/thesportsdb/search_teams
GET /rest/thesportsdb/get_team
GET /rest/thesportsdb/search_players
GET /rest/thesportsdb/get_league_table
GET /rest/thesportsdb/get_events_by_date
GET /rest/thesportsdb/get_last_events
GET /rest/thesportsdb/get_next_events
GET /rest/thesportsdb/report_feedback

Shell

curl "https://context.gnist.ai/rest/thesportsdb/search_teams?team_name=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"

Python

import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/thesportsdb/search_teams",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "team_name": "example"
},
)
print(resp.json())

OpenAPI Spec · Full API Docs

CLI Command Line

Command gc thesportsdb

CLI documentation will be available when the GnistAI SDK is published.

Install

pip install gnistai

Available Tools (8)

search_teams

Search for sports teams by name across all sports.

Parameter	Type	Required	Description
`team_name`	`string`	required	Team name to search for (e.g. 'Arsenal', 'Barcelona', 'Lakers').

get_team

Get detailed information for a specific team by its ID.

Parameter	Type	Required	Description
`team_id`	`string`	required	Numeric team ID from TheSportsDB (e.g. '133604' for Arsenal).

search_players

Search for players by team name and/or player name.

Parameter	Type	Required	Description
`team_name`	`any`	optional	Team name to filter players by (e.g. 'Arsenal').
`player_name`	`any`	optional	Player name to search for (e.g. 'Messi', 'LeBron').

get_league_table

Get league standings/table for a given league and season.

Parameter	Type	Required	Description
`league_id`	`string`	required	Numeric league ID (e.g. '4328' for English Premier League).
`season`	`string`	required	Season in YYYY or YYYY-YYYY format (e.g. '2024-2025').

get_events_by_date

Get sporting events scheduled for a specific date.

Parameter	Type	Required	Description
`date`	`string`	required	Date in YYYY-MM-DD format (e.g. '2025-03-15').
`sport`	`any`	optional	Sport filter (e.g. 'Soccer', 'Basketball', 'Ice Hockey'). Omit for all sports.