# GraphReel

> Provenance-backed film & TV entity resolution and identifier crosswalk (CC0 Wikidata backbone).

GraphReel maps external IDs (IMDb, TMDb, Wikidata, EIDR, …) to stable `gr_id` entities with full provenance for citation.

## Hosts

- API / MCP / OpenAPI: `https://api.graphreel.com` (set `GRAPHREEL_API_BASE`)
- Canonical entity pages + homepage: `https://graphreel.com` (set `GRAPHREEL_PUBLIC_BASE`)

## Canonical URLs

- Agent card (A2A): https://api.graphreel.com/.well-known/agent-card.json
- MCP discovery: https://api.graphreel.com/.well-known/mcp.json
- OpenAPI: https://api.graphreel.com/openapi.json
- Public REST: https://api.graphreel.com/v1
- MCP endpoint: https://api.graphreel.com/mcp
- Entity pages: https://graphreel.com/work/{gr_id}, https://graphreel.com/person/{gr_id}, https://graphreel.com/organization/{gr_id}

## Tools (REST /v1 and MCP)

- resolve_id — external ID → entity + crosswalk + provenance
- disambiguate — rank works by title (optional year, country)
- get_relationships — credits / filmography for a gr_id
- get_provenance — sources, verification, confidence for citation

## Auth

Public `/v1` requires `Authorization: Bearer <api_key>`. Mint with `scripts/mint_api_key.py --tier free`. Free tier responses include CC0 attribution. `/admin` requires `GRAPHREEL_ADMIN_TOKEN`.

## Docs

- Human API guide: https://gitlab.com/ravitejarx/graphreel/-/blob/main/docs/API.md
- Architecture: https://gitlab.com/ravitejarx/graphreel/-/blob/main/docs/ARCHITECTURE.md