Agents

Cursor

Add Openhandle to Cursor as an MCP server with one entry in mcp.json.

Cursor's agent can call Openhandle tools once the MCP server is configured for the project or globally.

1. Get a key

Create a Test key in the dashboard. It runs every endpoint against synthetic data for free.

2. Add the server

Create or edit .cursor/mcp.json in your project:

{
  "mcpServers": {
    "openhandle": {
      "url": "https://api.openhandle.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:OPENHANDLE_TEST_KEY}"
      }
    }
  }
}

Set OPENHANDLE_TEST_KEY in your environment. Cursor picks the server up on the next agent run. Check Cursor's MCP settings if the tools do not appear.

3. Ask

Read https://openhandle.dev/SKILL.md and follow it, then add a function to this project that returns a TikTok creator's last ten videos with views and likes.

The agent uses the MCP tools to try the call against test data, then writes the code against the REST API with your key in an environment variable.

Notes

  • The same server works with a Live key. Only the credential changes.
  • Tool names follow the operation IDs in the OpenAPI spec.

On this page