AI agents (MCP)

Connect your AI tool

Add the Affitor MCP server to Claude, Codex, ChatGPT, Cursor, VS Code, Grok, Muse Code or another MCP client, then sign in with Affitor. No API key needed.

View as Markdown

Add the Affitor MCP server to your AI tool, then sign in with your Affitor account. No API key needed. You will add the server, sign in on affitor.com, choose your programs and click Allow.

Before you start

  • An Affitor account with a program, or a program you joined as a partner.
  • Access is read-only today: reading is always on, and money actions always happen in Affitor.

Server URL

https://mcp.affitor.com/mcp

Every tool below uses this URL. For transport, sign-in and the full tool list, see the MCP server reference.

Claude

Claude on the web and Claude Desktop.

  1. Add the server in one click: Add to Claude.

Or add it by hand:

  1. In Claude, open Customize › Connectors.
  2. Click + Add, then Add custom connector. Name it Affitor, paste the URL and click Continue.
  3. Keep the detected sign-in settings. If Claude asks, pick Register automatically under OAuth client.
  4. Click Add and sign in to Affitor.
  5. As a brand, pick your programs; then click Allow.

On Team and Enterprise plans, an owner adds the connector in Organization settings › Connectors, and members click Connect.

Check it works: in a new chat, ask your AI tool "List my Affitor programs". It answers with your programs.

Codex

  1. Run this in your terminal:

    codex mcp add affitor --url https://mcp.affitor.com/mcp
  2. Sign in:

    codex mcp login affitor

Check it works: run codex mcp list: affitor is listed. Then ask your AI tool "List my Affitor programs". It answers with your programs.

Other MCP clients

Each section below matches a tab in the dashboard's Connect an AI tool, or a block under its Other tab. Any other MCP client also has steps for apps the dashboard does not list.

ChatGPT

  1. Go to chatgpt.com/plugins, click the plus button, then Add custom MCP server.
  2. Enter a name, and under Connection paste the URL.
  3. Set authentication to OAuth, review the warning and click I understand and want to continue.
  4. Click Create as a plugin and sign in to Affitor.
  5. As a brand, pick your programs; then click Allow.

Your workspace's policy may limit who can add custom MCP servers.

Check it works: in a new chat, ask your AI tool "List my Affitor programs". It answers with your programs.

Cursor

  1. Add the server in one click: Add to Cursor.

Or add it by hand:

  1. Add this to ~/.cursor/mcp.json:

    mcp.json
    {
      "mcpServers": {
        "affitor": { "url": "https://mcp.affitor.com/mcp" }
      }
    }
  2. In Cursor Settings › MCP, click Connect and sign in.

Check it works: in Cursor Settings, open MCP: affitor shows its tools. Then ask your AI tool "List my Affitor programs". It answers with your programs.

Claude Code

  1. Install the Affitor plugin (recommended):

    /plugin marketplace add Affitor/claude-plugins
    /plugin install affitor@affitor
  2. Open /mcp, pick affitor and sign in.

Or add the server by hand:

  1. Run this in your terminal:

    claude mcp add --transport http affitor https://mcp.affitor.com/mcp
  2. In Claude Code, type /mcp, pick affitor and sign in.

Add --scope user to use Affitor in every project.

Check it works: run claude mcp list: affitor shows Connected. Then ask your AI tool "List my Affitor programs". It answers with your programs.

VS Code

GitHub Copilot in VS Code.

  1. Add the server in one click: Add to VS Code.

Or add it by hand:

  1. Add this to .vscode/mcp.json in your workspace, or to the mcp.json of your user profile (or run MCP: Add Server from the Command Palette):

    mcp.json
    {
      "servers": {
        "affitor": { "type": "http", "url": "https://mcp.affitor.com/mcp" }
      }
    }
  2. Start the server and sign in when VS Code asks.

Check it works: in Copilot Chat in Agent mode, ask your AI tool "List my Affitor programs". It answers with your programs.

Grok

  1. Go to grok.com/connectors, click New Connector, then Custom.
  2. Paste the URL and sign in to Affitor.
  3. Pick your programs, or All current and future programs, then click Allow.

Check it works: in a new chat, ask your AI tool "List my Affitor programs". It answers with your programs.

Muse Code

  1. Add this to ~/.config/muse/settings.json (create the file if it does not exist). If it exists, add only the affitor entry under mcpServers and keep everything else. Keep one mcpServers section. Having both mcpServers and mcp_servers disables MCP.

    settings.json
    {
      "schema_version": 1,
      "mcpServers": {
        "affitor": {
          "type": "streamable-http",
          "url": "https://mcp.affitor.com/mcp",
          "enabled": true,
          "required": false
        }
      }
    }
  2. Sign in from your terminal:

    muse mcp login affitor
  3. Pick your programs, or All current and future programs, then click Allow.

Check it works: in a Muse Code session, run /mcp: affitor shows its tools. Then ask your AI tool "List my Affitor programs". It answers with your programs.

Any other MCP client

  1. Add this to your client's MCP config:

    {
      "mcpServers": {
        "affitor": { "url": "https://mcp.affitor.com/mcp" }
      }
    }
  2. Restart the client and sign in when it asks.

Apps on your own computer connect through http://127.0.0.1 or http://localhost. A web app connects only if Affitor accepts its return address; the MCP server reference lists them.

Check it works: ask your AI tool "List my Affitor programs". It answers with your programs.

Some clients add the server with their own command or screen:

Gemini CLI

gemini mcp add --transport http affitor https://mcp.affitor.com/mcp
# Then, inside Gemini CLI: /mcp auth affitor

OpenClaw

openclaw mcp add affitor --url https://mcp.affitor.com/mcp --transport streamable-http --auth oauth
openclaw mcp login affitor

Hermes Agent

hermes mcp add affitor --url https://mcp.affitor.com/mcp --auth oauth
# To sign in again later:
hermes mcp login affitor

Perplexity

  1. Open Plugins in the sidebar, or Customize › Connectors if you don't see Plugins.
  2. Select Add custom › Connector › Add MCP connector, then Remote.
  3. Enter a name, and under MCP Server URL paste https://mcp.affitor.com/mcp.
  4. Under Authentication pick OAuth and under Transport pick Streamable HTTP. Affitor supports automatic registration, so no Client ID or Client Secret is needed.
  5. Check the acknowledgement box, click Add, then click the connector card and sign in to Affitor.

In an organization, members can add custom connectors only if an admin allows it.

What the AI can do

When you sign in, you choose the programs the AI can read. Access is read-only today: reading is always on, and money actions always happen in Affitor.

To see or remove a connection, brands open Program settings › Developers › AI agents; partners open Integrations from the account menu.

Next: set up tracking

For brands: in the dashboard, Program settings › Tracking › With AI shows this prompt with your website, program ID and API base filled in. Paste it into your AI tool. It follows the agent skill: click tracking, sign-up leads, then sales.

Add Affitor affiliate tracking to <your website>.

Program ID: <your program ID>
API base: https://api.affitor.com
API key: read it from the AFFITOR_API_KEY environment variable. Never print it or put it in browser code.

Follow https://affitor.com/docs/skill.md in order:
click tracking (§4), signup lead (§5), then the sale (§6).
For the sale, look at how the site takes payments and use the first mode in §6 that fits.
If you can't read or change the code, ask me what you need and tell me exactly what to add, file by file.
Then tell me when it's deployed.

The prompt reads your program API key from the AFFITOR_API_KEY environment variable where the AI tool runs; never put the key in the prompt. Use a key with Full access: a Tracking only key cannot run the readiness check the skill ends with. If you do not have the key's value, an owner or admin creates or rotates one in Program settings › Developers › API keys. See the tracking guide.

Share feedback

Tell us what is missing or unclear on “Connect your AI tool”.

Last updated Nov 10, 2026

On this page

Share feedback

Tell us what is missing or unclear on “Connect your AI tool”.