Assistant tools
A
POST
/mcp
The registry as assistant tools
The registry exposed as MCP tools, so an assistant can query the archive without any glue code.
Plan
This endpoint needs Archive.
Calling it on a lower plan returns a 403 naming the plan it needs and
a link to pricing, never a bare refusal.
Request
curl "https://api.footballsoccerapi.com/mcp" \ -H "X-API-Key: $FSAPI_KEY"
const res = await fetch("https://api.footballsoccerapi.com/mcp", { headers: { "X-API-Key": process.env.FSAPI_KEY } }); const { data, meta } = await res.json();
import os, requests r = requests.get( "https://api.footballsoccerapi.com/mcp", headers={"X-API-Key": os.environ["FSAPI_KEY"]}, ) data = r.json()["data"]
$ch = curl_init("https://api.footballsoccerapi.com/mcp"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["X-API-Key: {$key}"], ]); $data = json_decode(curl_exec($ch), true)["data"];
Example response
A real row from the archive, fetched when this page rendered. Run it against your own key below.
200 OK
application/json
{
"tools": [
{
"name": "fsapi.matches",
"description": "Search matches"
},
{
"name": "fsapi.odds",
"description": "Exchange prices for a match"
}
]
}
Run it live
Paste your key and fire the real request. The key is kept in this browser only and never sent anywhere but the API.