MCP server

claude mcp add --transport http getaff https://www.getaff.org/api/mcp \
  --header "Authorization: Bearer $GETAFF_API_KEY"

{
  "mcpServers": {
    "getaff": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.getaff.org/api/mcp",
        "--header",
        "Authorization:${GETAFF_AUTH}"
      ],
      "env": {
        "GETAFF_AUTH": "Bearer gaff_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

{
  "mcpServers": {
    "getaff": {
      "url": "https://www.getaff.org/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GETAFF_API_KEY}"
      }
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "getaff-key",
      "description": "GetAff API key",
      "password": true
    }
  ],
  "servers": {
    "getaff": {
      "type": "http",
      "url": "https://www.getaff.org/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:getaff-key}"
      }
    }
  }
}

from openai import OpenAI
import os

client = OpenAI()
response = client.responses.create(
    model="gpt-5",
    tools=[{
        "type": "mcp",
        "server_label": "getaff",
        "server_url": "https://www.getaff.org/api/mcp",
        "headers": {"Authorization": f"Bearer {os.environ['GETAFF_API_KEY']}"},
        "require_approval": "always",
    }],
    input="List my GetAff sites, then find wedding creators in France for the first one.",
)
print(response.output_text)

const base = 'https://www.getaff.org/api';
const headers = {
  Authorization: `Bearer ${process.env.GETAFF_API_KEY}`,
  'Content-Type': 'application/json',
  'Idempotency-Key': crypto.randomUUID(), // a retry never pays twice
};
const url = `${base}/v1/sites/${siteId}/partner-search`;

let res = await fetch(url, { method: 'POST', headers, body: JSON.stringify({ includeLive: true }) });
if (res.status === 402) {
  const { error } = await res.json(); // error.code === "cost_confirmation_required"
  const credits = error.details.estimate.credits;
  if (!(await askTheUser(`Spend about ${credits} credits?`))) return;
  headers['Idempotency-Key'] = crypto.randomUUID();
  res = await fetch(url, {
    method: 'POST',
    headers,
    body: JSON.stringify({ includeLive: true, confirmCost: credits }),
  });
}
const { data } = await res.json();

curl -s https://www.getaff.org/api/mcp \
  -H "Authorization: Bearer $GETAFF_API_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_partners",
                 "arguments":{"siteId":"Wq3b9ZK1","includeLive":true}}}'

# → structuredContent.status = "confirmation_required", with the estimate
#   and a confirmToken. Nothing was spent. After the user agrees:
#   same call, "arguments":{"siteId":"Wq3b9ZK1","includeLive":true,"confirmToken":"gcf_…"}

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(new URL('https://www.getaff.org/api/mcp'), {
  requestInit: { headers: { Authorization: `Bearer ${process.env.GETAFF_API_KEY}` } },
});
const client = new Client({ name: 'my-agent', version: '1.0.0' });
await client.connect(transport);

const { tools } = await client.listTools();
const sites = await client.callTool({ name: 'list_sites', arguments: {} });
console.log(tools.map((t) => t.name), sites.structuredContent);

import asyncio, os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    headers = {"Authorization": f"Bearer {os.environ['GETAFF_API_KEY']}"}
    async with streamablehttp_client("https://www.getaff.org/api/mcp", headers=headers) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])
            sites = await session.call_tool("list_sites", {})
            print(sites.structuredContent)

asyncio.run(main())