← quofuit

API & MCP

Query Quo Fuit from your code (REST) or plug it into your AI assistant (MCP). Every answer carries its sources: a documented fact is never a guess.

1 · Authentication

Both surfaces use the same key, tied to the Pro plan. Generate it in Settings → api & mcp on quofuit.com (sign in, then click your avatar). The key is shown once; regenerating replaces it, revoking kills it instantly.

Authorization: Bearer qf_your_key_here

Quota: metered calls draw from your Pro daily quota (10,000 searches/day, fair use). Free calls (search, suggestions, crossings) are unlimited. Quota resets at midnight UTC.

2 · MCP server

The MCP endpoint is https://quofuit.com/mcp (Streamable HTTP). Add it to Claude Code:

claude mcp add --transport http quofuit https://quofuit.com/mcp \
  --header "Authorization: Bearer qf_your_key_here"

Or as a claude.ai custom connector: Settings → Connectors → Add custom connector → URL https://quofuit.com/mcp, and pass your key as the Authorization header where supported.

Available tools:

toolwhat it doesquota
search_personfind a historical person by name or aliasfree
person_presencesall documented presences of a person: dated, placed, sourced, with confidence levels (optional year filter)1 search
search_placefind a place in the gazetteer (1.33M historical places)free
people_at_placewho is documented at a place during a period1 search
crossingsdocumented co-presences of a person (correlations, never proof of a meeting)free

3 · REST API

Base URL: https://quofuit.com/api/v1. All responses are JSON.

endpointdescriptionquota
GET /search?q={name}search people (local catalog + candidates)free
GET /resolve?title={enwiki title}import/open a record by English Wikipedia titlefree
GET /person/{id}person record (internal id or Wikidata Qxxx)free
GET /person/{id}/observationsdated, placed, sourced presences with confidence + AI verification1 search
GET /person/{id}/copresencedocumented co-presences (correlations only)free
GET /place/suggest?q={name}place suggestions from the gazetteerfree
GET /place/people?id={place}&start={date}&end={date}people documented at a place during a period1 search
GET /source/{id}source record backing an observationfree

Example:

curl "https://quofuit.com/api/v1/person/Q34969/observations" \
  -H "Authorization: Bearer qf_your_key_here"

4 · The doctrine, in your data

Every observation carries a confidence level and its source (title, url, provider), plus an ai_verification verdict when our local judge has reviewed it. Co-presences are correlations: two people documented in the same place and period. They are never proof of a meeting, and neither the API nor the MCP will present them as one. Please keep that distinction in what you build.

5 · Fair use

Rate limit: 600 requests/minute per IP. The Pro quota (10,000 searches/day) is a fair-use guardrail, not a target. One key per account; you are responsible for calls made with your key. Questions: contact@quofuit.com.