Fitaio

Connect Cursor

Cursor reads MCP servers from an mcp.json file and supports custom headers. Cursor's settings move between releases; the file and JSON below are what stay the same.

Before you start

Create an API key in Fitaio (Settings, then Developer), with read and write scope if the agent should log entries.

Connect

Create or edit ~/.cursor/mcp.json for all projects, or .cursor/mcp.json inside one project:

{
  "mcpServers": {
    "fitaio": {
      "url": "https://fitaio.app/mcp",
      "headers": { "Authorization": "Bearer fitaio_YOUR_KEY" }
    }
  }
}

Do not commit a project-level file that contains your key.

Check it worked

Open Cursor Settings, then MCP. fitaio should be listed with a green status and its tools expanded. In the agent chat, ask:

Use Fitaio to list my training plans and tell me which one is active.

The agent calls list_training_plans. See the tool reference for everything else it can do.

Troubleshooting

  • Red status or no tools. Check the JSON is valid and the URL is exactly https://fitaio.app/mcp. Toggle the server off and on in settings.
  • invalid_key. The key was revoked or mistyped. Create a new one and update the file.
  • insufficient_scope. The key is read-only; create one with read and write scope.