MCP Server

Quick start: connect ChatGPT or Claude

Add FormFav as a custom connector and sign in with your FormFav account. It works on the free plan, and you never handle an API key.

Paste the whole address, including https://. Some apps reject a bare domain.

Which setup do I need?

Apps with a connector or custom-connector screen sign in with OAuth. Editors, command-line tools and scripts that read a config file send your API key instead.

API key setup (editors, command line, scripts)

Tools that read an MCP config file can't do a browser sign-in, so they send your API key in the X-API-Key header, the same as the REST API (or as an Authorization: Bearer token if a client only has that field). Pro users automatically get Pro tools; Free users are rate-limited against their own quota. Replace your_api_key_here below with a free key from formfav.com/get-api-key.

Claude Desktop (config file)

Claude Desktop's config file is stdio-only, so we bridge to the hosted HTTP server through the mcp-remote proxy. It's pulled on first run by npx — no manual install — but you do need Node.js on your machine.

Open Claude Desktop. If you don't see a Developer tab in Settings, enable it first: Help > Troubleshooting > Enable Developer Mode (one-time step). Then go to Settings > Developer > Edit Config and add:

{
  "mcpServers": {
    "formfav": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.formfav.com/mcp/",
        "--header",
        "X-API-Key: your_api_key_here"
      ]
    }
  }
}

{
  "mcpServers": {
    "formfav": {
      "type": "http",
      "url": "https://api.formfav.com/mcp/",
      "headers": {
        "X-API-Key": "your_api_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "formfav": {
      "url": "https://api.formfav.com/mcp/",
      "headers": {
        "X-API-Key": "your_api_key_here"
      }
    }
  }
}

Standalone Setup

Run the MCP server as a local process using uv. All tool calls use the single API key set in the environment.

{
  "mcpServers": {
    "formfav": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_server"],
      "cwd": "/path/to/formfav-mcp/src",
      "env": {
        "FORMFAV_API_KEY": "your_api_key_here"
      }
    }
  }
}

Example Prompts

Once connected, try asking your AI assistant:

• •"What meetings are on tomorrow?"
• •"Show me the race form for Flemington Race 5 today"
• •"What are the model's win and place chances for Randwick Race 3?" (Pro)
• •"How does James McDonald perform at Moonee Valley?" (Pro)
• •"Is there a barrier bias at Flemington on soft tracks?" (Pro)
• •"Look up the career stats for Via Sistina" (Pro)

Worked examples

Longer questions that combine several tools. Each shows what the assistant does behind the scenes and what to keep in mind. You don’t need to name the tools; the assistant picks them.

Troubleshooting

• •Claude says it can't connect or sign in — Open the connector's settings and set Authentication to Sign in now and OAuth client to Register automatically, which is the combination we've tested.
• •The connector is added but returns "Invalid or missing API key" — It was added without signing in (for example No sign-in). Remove it and add it again with a sign-in option so you're sent to formfav.com to approve.
• •The app rejects the URL — Paste the full address, https://api.formfav.com/mcp, including https:// and with no trailing text.
• •"Invalid or missing API key" — In hosted mode, check the X-API-Key header value in your config. In standalone mode, check FORMFAV_API_KEY is set correctly.
• •A connector asks you to sign in again, or says authorization failed — The connection was disconnected, or went unused for about 30 days. Remove the connector in the app and add it again to re-approve.
• •"You already have 10 connected apps" — Disconnect one from the Connected apps list in your API keys dialog, then approve the new one.
• •"Pro subscription required" — The tool requires a Pro plan. Upgrade at formfav.com/pricing.
• •Tools not appearing — Restart your MCP client after editing config. Check the developer console for connection errors.
• •Claude Desktop: "spawn npx ENOENT" — mcp-remote needs Node.js. Install from nodejs.org (LTS) and restart Claude Desktop.
• •Standalone: cannot connect — Verify cwd points to the correct directory and uv is installed and on your PATH.