Skip to main content

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
AuthenticationBearer token (API key)

Generic Configuration

Most MCP clients accept a configuration in this format:
{
  "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

ClientTransport SupportNotes
Claude DesktopStreamable HTTPFull support
CursorStreamable HTTPFull support
Continue.devStreamable HTTPFull support
ClineStreamable HTTPFull support

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