Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.affonso.io/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Affonso MCP uses the Streamable HTTP transport, which is the standard for cloud-hosted MCP servers. Any client that supports this transport can connect to Affonso.

Connection Details

SettingValue
URLhttps://api.affonso.io/mcp
TransportStreamable HTTP
AuthenticationOAuth 2.1 (automatic) or Bearer token (API key)

Authentication

Clients that support OAuth (like Claude.ai, ChatGPT, Claude Desktop) handle authentication automatically. Just enter the server URL and you’ll be guided through a login flow — no API key needed. The server publishes OAuth metadata at:
  • /.well-known/oauth-protected-resource
  • /.well-known/oauth-authorization-server
Clients discover these endpoints automatically per the MCP specification.

API Key

For clients that don’t support OAuth, authenticate with a Bearer token:
{
  "url": "https://api.affonso.io/mcp",
  "headers": {
    "Authorization": "Bearer sk_live_your_api_key_here"
  },
  "transport": "streamable-http"
}

HTTP Request Format

For custom implementations, MCP requests are standard HTTP POST:
curl -X POST https://api.affonso.io/mcp \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "affonso_list_affiliates",
      "arguments": {
        "limit": 10
      }
    }
  }'

Supported Clients

Confirmed Compatible

ClientAuth MethodNotes
Claude.aiOAuthJust enter the URL — Setup guide
ChatGPTOAuthJust enter the URL — Setup guide
Claude DesktopOAuth or API keySetup guide
CursorAPI keySetup guide
Continue.devAPI keyUse generic config above
ClineAPI keyUse generic config above

Building Custom Clients

If you’re building a custom MCP client, use the official MCP SDK:
npm install @modelcontextprotocol/sdk
Example TypeScript client:
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://api.affonso.io/mcp"),
  {
    requestInit: {
      headers: {
        Authorization: "Bearer sk_live_your_api_key"
      }
    }
  }
);

const client = new Client({
  name: "my-app",
  version: "1.0.0"
});

await client.connect(transport);

// List available tools
const tools = await client.listTools();

// Call a tool
const result = await client.callTool({
  name: "affonso_list_affiliates",
  arguments: { limit: 10 }
});

Server Capabilities

The Affonso MCP server supports:
CapabilitySupported
ToolsYes (18 tools)
ResourcesNo
PromptsNo
SamplingNo

Rate Limits

MCP requests share the same rate limits as REST API requests:
PlanRequests/min
Launch300
Growth600
Elite1,200
Enterprise3,000+

Next Steps

Claude

Claude.ai & Claude Desktop setup

ChatGPT

ChatGPT setup

Cursor

Cursor IDE setup