Cursor

Cursor supports MCP servers, letting you use Toolcog directly in your IDE for API operations while coding.

Prerequisites

• Cursor installed (download)
• A Toolcog account (sign up)

Configuration

Cursor uses JSON configuration files for MCP servers. Choose based on your needs:

User-Level Configuration

Create or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "toolcog": {
      "url": "https://mcp.toolcog.com"
    }
  }
}

Project-Level Configuration

Create .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "toolcog": {
      "url": "https://mcp.toolcog.com/mycompany/project-catalog"
    }
  }
}

Configuration via UI

You can also add MCP servers through the Cursor UI:

1. Open File → Preferences → Cursor Settings
2. Select the MCP option
3. Click to add a new server
4. Enter the Toolcog URL: https://mcp.toolcog.com

Using Toolcog

After configuration, Toolcog’s tools are available in Cursor’s AI features. Ask Cursor:

“Find the Stripe API operation for creating a payment intent”

Cursor will use Toolcog to discover the operation, show you its interface, and help you use it in your code.

Authentication

When Cursor needs to access your Toolcog account:

1. Cursor displays an authorization link
2. Click to open your browser and sign in to Toolcog
3. Return to Cursor

For downstream services (GitHub, Stripe, etc.), the same flow applies when you try to call an operation that requires authorization.

Catalogs

Connect to specific catalogs by using scoped URLs:

{
  "mcpServers": {
    "toolcog-internal": {
      "url": "https://mcp.toolcog.com/mycompany/internal-apis"
    },
    "toolcog-public": {
      "url": "https://mcp.toolcog.com"
    }
  }
}

Limitations

• Cursor supports up to 40 tools at once
• MCP Resources are not yet supported in Cursor (only Tools)

Verify It’s Working

In Cursor, ask the AI:

“What operations does Toolcog have available for Stripe?”

If you see a list of Stripe operations, Toolcog is connected.

Troubleshooting

Server not connecting

• Verify your config file is valid JSON
• Check the file is in the correct location
• Restart Cursor after configuration changes

Tools not appearing

• Ensure the MCP server is enabled in Cursor Settings
• Check you’re not exceeding the 40-tool limit

Authentication errors

• Click the authorization link to sign in to Toolcog
• Verify you’re signed in at toolcog.com

Next Steps

• Quick Start — Your first API operation
• API Meta-Tools — How discovery, learning, and execution work