Footlambert MCP

Footlambert exposes a public, read-only Model Context Protocol (MCP) endpoint for Paris theater, movie, showtime, and retrospective data.

Endpoint

https://seance.paris/mcp

Transport: Streamable HTTP. Protocol version: 2025-06-18.

All tools are read-only and intended for query use.

Discovery

MCP endpoint: https://seance.paris/mcp
Human docs: https://seance.paris/mcp-docs
LLM index: https://seance.paris/llms.txt
Metadata probe: GET /mcp

HTTP Requirements

Initialize with POST /mcp and JSON-RPC initialize.
Send Accept: application/json, text/event-stream for MCP POST requests.
Send Mcp-Session-Id on all follow-up requests after initialize.
Send MCP-Protocol-Version: 2025-06-18 after initialize.
Close sessions with DELETE /mcp.

Canonical IDs

theater:<slug>
movie:wikidata:<QID>
movie:slug:<slug>
person:<role>:<id>
date:<yyyy-mm-dd>

Data Source

The endpoint serves data from the production Footlambert snapshot published to DigitalOcean Spaces and refreshed multiple times per day.

Notes

No mutation tools are exposed.
Movie responses use Wikidata-oriented IDs and do not expose IMDb IDs.
Showtime timestamps are normalized to ISO-8601 values in the Europe/Paris timezone.
Responses may be rate-limited for abuse protection.

Tools

search: args query, type?, date?, limit?. Result list across theaters/movies/people/showtimes.
fetch: args id. Canonical entity payload by ID (theater/movie/person/date).
get_theater: args slug_or_name. Theater details + showtimes grouped by date.
get_movie: args movie_id_or_slug. Movie details + showtimes grouped by theater.
get_showtimes: args date?, theater_slug?, movie?, movie_id?, limit?. Flat showtime events with Paris-normalized times.
get_retrospectives: args role?, person?, limit?. Retrospective buckets for directors/writers/cast.
get_person: args id_or_name, role?. Person details + associated movies + showtimes by date.

Initialize Example

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": { "name": "example-client", "version": "1.0.0" }
  }
}

Tool Call Example

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_showtimes",
    "arguments": { "date": "2026-02-18", "limit": 2 }
  }
}

Response Contract

Success: { result: { content: [...], structuredContent: {...} } }
Tool error: { result: { isError: true, content: [...], structuredContent: { error } } }

Endpoint Return Examples

GET /mcp (metadata probe, no session)

Request:

curl -s https://seance.paris/mcp

Response:

{
  "name": "footlambert-mcp",
  "version": "1.0.0",
  "protocol_version": "2025-06-18",
  "transport": "streamable-http",
  "endpoint": "https://seance.paris/mcp",
  "docs": "https://seance.paris/mcp-docs",
  "llms": "https://seance.paris/llms.txt",
  "tools": ["search", "fetch", "get_theater", "get_movie", "get_showtimes", "get_retrospectives", "get_person"],
  "canonical_ids": {
    "theater": "theater:<slug>",
    "movie": ["movie:wikidata:<QID>", "movie:slug:<slug>"],
    "person": "person:<role>:<id>",
    "date": "date:<YYYY-MM-DD>"
  },
  "time_policy": {
    "timezone": "Europe/Paris",
    "format": "ISO-8601 with Paris UTC offset"
  }
}

POST /mcp initialize (JSON-RPC)

Request:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": { "name": "example-client", "version": "1.0.0" }
  }
}

Response:

{
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": { "logging": {}, "tools": { "listChanged": true } },
    "serverInfo": { "name": "footlambert-mcp", "version": "1.0.0" }
  },
  "jsonrpc": "2.0",
  "id": 1
}
// HTTP response header includes: Mcp-Session-Id: <uuid>

DELETE /mcp (close session)

Request:

curl -X DELETE https://seance.paris/mcp -H "Mcp-Session-Id: <session-id>"

Response:

HTTP 200 with empty body

POST /mcp tool call without session

Request:

{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": { "name": "search", "arguments": { "query": "mk2" } }
}

Response:

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32000,
    "message": "No active MCP session. Start with an initialize request or include a valid mcp-session-id header."
  },
  "id": null
}

GET /mcp with Accept: text/event-stream but no session

Request:

curl -H "Accept: text/event-stream" https://seance.paris/mcp

Response:

HTTP 405
{
  "error": "Sessionless GET event streams are not supported. Initialize with POST /mcp first and send Mcp-Session-Id on follow-up requests."
}