Skip to main content

​
Prerequisites

  • Cursor IDE installed (Download)
  • An Affonso API key from your dashboard
  • Cursor version with MCP support

​
Configuration

​
Step 1: Open Cursor Settings

  1. Open Cursor
  2. Go to Settings (Cmd/Ctrl + ,)
  3. Navigate to Features > MCP

​
Step 2: Add MCP Server

Add the following configuration: 
{
  "mcpServers": {
    "affonso": {
      "url": "https://api.affonso.io/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_your_api_key_here"
      },
      "transport": "streamable-http"
    }
  }
}
Replace sk_live_your_api_key_here with your actual Affonso API key.

​
Step 3: Restart Cursor

After saving the configuration, restart Cursor to activate the MCP connection.

​
Verify Setup

In the Cursor chat, try: 
@affonso List my top affiliates
Or ask about available tools: 
What can I do with Affonso?

​
Configuration File Location

Alternatively, you can edit the Cursor configuration file directly: 
~/.cursor/mcp.json

​
Using MCP in Cursor

​
In Chat

Use the @affonso mention to interact with your affiliate data: 
@affonso Show me all pending affiliates
@affonso Create an affiliate for [email protected]
@affonso What's the total commission for affiliate aff_123?

​
In Composer

When writing code, Cursor can use Affonso data to help you: 
Help me build a dashboard that shows affiliate performance.
Use @affonso to get the current affiliate data structure.

​
Local Development

For development with a local Affonso API: 
{
  "mcpServers": {
    "affonso-local": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer sk_dev_your_dev_key"
      },
      "transport": "streamable-http"
    }
  }
}

​
Troubleshooting

  1. Check that the URL is correct: https://api.affonso.io/mcp
  2. Verify your API key is valid
  3. Restart Cursor completely
  1. Check your API key has the required scopes
  2. Verify the key is active in your dashboard
  3. Ensure you’re using the correct environment (live vs dev)
  1. Check your internet connection
  2. Large data requests may take longer
  3. Use filters to reduce response size

​
Next Steps

All Tools

Explore available MCP tools

Examples

See sample queries and use cases