Connect an AI agent (MCP)

Human Lineage exposes a public MCP server over Streamable HTTP — no API key required:

https://humanlineage.org/api/mcp

Settings → Connectors → Add custom connector → paste the endpoint URL above → Add.

Add to .mcp.json in your project (or run claude mcp add):

{
  "mcpServers": {
    "human-lineage": {
      "type": "http",
      "url": "https://humanlineage.org/api/mcp"
    }
  }
}

Add to .cursor/mcp.json (or Settings → MCP → Add new MCP server):

{
  "mcpServers": {
    "human-lineage": {
      "url": "https://humanlineage.org/api/mcp"
    }
  }
}

Settings → Connectors → Advanced → enable developer mode, then Add connector → paste the endpoint URL above. (Requires a ChatGPT plan with connector support.)

Any MCP client that supports remote Streamable HTTP servers works the same way — paste the endpoint URL where the client asks for an MCP server. Clients that only support local (stdio) servers need a bridge such as mcp-remote.

• search_person — search the graph by name, returns matches with profile URLs
• get_person — full details for a person by ID
• get_relatives — immediate family (parents, children, spouses) as text
• get_family_image — a visual family-tree card image
• search_place — search places by name, returns matches with place URLs
• get_place — place details: hierarchy and recorded person count

Human Lineage does not store data of living persons — only deceased individuals are included. Requests are rate-limited to 60/minute per client.

• “Search Human Lineage for Johann Sebastian Bach”
• “Show me the profile of Marie Curie on Human Lineage”
• “Who are the parents and children of Charles Darwin according to Human Lineage?”
• “Show me a family tree image of Johann Ambrosius Bach”
• “Find every person named Kowalski born before 1900 on Human Lineage”
• “Is Albert Einstein's death date recorded on Human Lineage?”
• “Get the spouse and siblings of Ludwig van Beethoven from Human Lineage”
• “Look up Nikola Tesla on Human Lineage and summarize his life facts”
• “Compare the birth places of Wolfgang Amadeus Mozart and Joseph Haydn using Human Lineage”
• “Show me a visual family diagram for Isaac Newton”
• “Search Human Lineage for people with the surname Romanov”
• “What relatives does Ada Lovelace have on Human Lineage?”
• “Find the profile URL for Frederic Chopin on Human Lineage”
• “Show a family tree picture of Maria Sklodowska-Curie's household”
• “Search Human Lineage for the place Eisenach and tell me how many people are recorded there”
• “What's the location hierarchy of Salzburg on Human Lineage?”
• “Search Human Lineage for the place Krakow”
• “How many people on Human Lineage are recorded in Vienna?”
• “What country and region does Leipzig belong to according to Human Lineage?”
• “Compare how many people are recorded in Prague vs Warsaw on Human Lineage”