Docs/ AI agents & MCP

AI agents & MCP

The MCP server, llms.txt, the OpenAPI spec and the AI companion kit for Cursor, Claude Code and Codex.

MCP server

FundFacts runs a remote Model Context Protocol server over Streamable HTTP at https://fundfactsapi.com/api/mcp. It exposes five tools — get_fund, search_funds, compare_funds, analyze_portfolio and fund_overlap — that behave exactly like the REST endpoints and spend the same credits. Any MCP client that supports remote servers with a bearer header can use it: Claude Desktop and Claude Code, Cursor, Windsurf, ChatGPT connectors, or your own agent.

Claude Desktop / Cursor / Windsurf configuration — json
{
  "mcpServers": {
    "fundfacts": {
      "url": "https://fundfactsapi.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ffk_your_api_key"
      }
    }
  }
}

Claude Code
claude mcp add --transport http fundfacts https://fundfactsapi.com/api/mcp --header "Authorization: Bearer ffk_your_api_key"

Clients that only speak stdio can bridge with npx -y mcp-remote https://fundfactsapi.com/api/mcp --header "Authorization: Bearer ffk_...".

Machine-readable entry points

`/openapi.json`	OpenAPI 3.1 for every endpoint, with the full FundData schema. Also /openapi.yaml.
`/llms.txt`	Index of the documentation and content pages, in the llms.txt format read by answer engines.
`/llms-full.txt`	The whole reference in one Markdown file: endpoints, credits, every field, the rules for agents, recipes, plans, MCP and the glossary.
`/api/v1/demo/funds/{isin}`	A real payload without a key, for an agent to verify the shape.

AI companion kit

Every paid plan (from Starter at $9) includes a kit generated from this very field reference on every download from your dashboard, with your plan and — optionally — a dedicated key baked in. Drop the files at the root of the project your coding agent works in and ask for the tool you want; the agent reads them before it writes code.

AGENTS.md: the endpoints, envelope and every field with its meaning, your plan's credits and the quota headers, freshness and timeout rules, error handling, a reference client in TypeScript and Python, and recipes (comparison table, portfolio look-through, screener, factsheet page, change monitor, export). Read by Cursor, Claude Code, Codex, Copilot and Windsurf.

.cursor/rules/fundfacts-api.mdc and .claude/skills/fundfacts-api/SKILL.md: the same rules in the native Cursor and Claude Code formats, attached whenever an ISIN, fund or factsheet comes up.

openapi.yaml and fundfacts.d.ts with typed FundResponse, FundData, BatchResponse, PortfolioResponse and OverlapResponse declarations.

The public edition of AGENTS.md — without a key or plan — is /llms-full.txt.