Skip to main content

Introducing the JoinBrands MCP Server: Connect Your Account to Claude & Other AI Tools

A new way for brands to interact with JoinBrands through Claude Code, Claude Desktop, Cursor, VS Code & more. 🤖

Written by Anastasija

We’re excited to introduce the JoinBrands MCP Server — a brand new way for brands to interact with JoinBrands directly from Claude Code, Claude Desktop, Cursor, VS Code, and other AI tools that support MCP. 🤖✨
​

By connecting your JoinBrands account to your favorite AI tool, you can automate parts of your workflow and access key parts of the platform without ever leaving your editor or chat window.

💡 What Is the MCP Server?

MCP (Model Context Protocol) is an open standard that lets AI tools securely connect to external platforms. With the JoinBrands MCP, your AI tool of choice can read information from your JoinBrands account and help you work faster.

This first release is intentionally lightweight and read-only, giving you access to:

  • Campaigns: Review the campaigns associated with your account.

  • Jobs: Pull up the jobs running under each of your campaigns.

  • Job Content: Access the creator-submitted content tied to your jobs.

This is just the beginning — we’ll be expanding what the MCP can do based on your feedback. 🚀

📍 Where to Find It

You’ll find everything you need on the new AI Integrations page in your JoinBrands account:

👉 https://us.brand.joinbrands.com/settings/mcp

Or, from your account, go to Settings → AI integrations.

🛠️ How to Set It Up

There are two ways to connect — pick whichever fits your tool best:

  • OAuth (recommended): Sign in with your JoinBrands account directly from your AI tool. The simplest option.

  • API Token: Generate a personal token and paste it into your tool’s config. Useful when OAuth isn’t supported.

🔐 Heads up:
​
Each API token grants access to your JoinBrands account — please keep tokens private and don’t share them.

🔗 Option 1: Connect with OAuth

The MCP server URL is the same for every client:

https://api.joinbrands.com/mcp

Pick your tool below and follow the steps.

Claude (Desktop App)

  1. Open Claude settings, then go to Customize and Connectors.

  2. Choose Add custom connector and paste the MCP server URL: https://api.joinbrands.com/mcp

  3. Click Connect and finish the JoinBrands sign-in.

Claude Code (CLI)

  1. Run this command in your terminal:

    claude mcp add --transport http joinbrands https://api.joinbrands.com/mcp

  2. Open Claude Code and run /mcp to complete sign-in.

Codex (CLI)

  1. Run in your terminal:

    codex mcp add joinbrands --url https://api.joinbrands.com/mcp

  2. Run the login command to complete OAuth:

    codex mcp login joinbrands

  3. Run codex mcp list to verify it was added.

Cursor (IDE)

  1. Add the following to ~/.cursor/mcp.json:

    {
  "mcpServers": {
    "joinbrands": {
      "url": "https://api.joinbrands.com/mcp"
    }
  }
}

  2. Restart Cursor.

  3. If prompted, complete OAuth for the JoinBrands MCP server.

VS Code (IDE)

  1. Create .vscode/mcp.json in your project:

    {
  "servers": {
    "joinbrands": {
      "type": "http",
      "url": "https://api.joinbrands.com/mcp"
    }
  }
}

  2. Open Copilot Chat in Agent mode and enable JoinBrands from tools.

Other MCP Clients

If you use a different MCP-compatible client:

  1. Choose HTTP or Streamable HTTP as the transport.

  2. Paste the MCP server URL — https://api.joinbrands.com/mcp — and complete the JoinBrands sign-in when prompted.

🔑 Option 2: Connect with an API Token

Prefer to skip OAuth, or using a client that doesn’t support it? You can authenticate with a personal API token instead.

Generate Your Token

  1. Go to Settings → AI integrations.

  2. Scroll down to the API tokens section and click Generate token.

  3. Copy the token and store it somewhere safe — you’ll paste it into your AI tool’s config below.

⚠️ Important: Treat your API token like a password. Anyone with this token can access your JoinBrands account through MCP.

Claude (Desktop App)

Edit your claude_desktop_config.json file and paste your token into the snippet below, then restart Claude Desktop:

{
  "mcpServers": {
    "joinbrands": {
      "type": "http",
      "url": "https://api.joinbrands.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Claude Code (CLI)

Add the JoinBrands MCP server from your terminal, passing the token as a header. Paste your token into the command before running it:

claude mcp add --transport http joinbrands https://api.joinbrands.com/mcp --header "Authorization: Bearer <your-token>"

Codex (CLI)

Add the entry below to ~/.codex/config.toml. Paste your token into the snippet, then restart Codex to load the server:

[mcp_servers.joinbrands]
transport = "http"
url = "https://api.joinbrands.com/mcp"
headers = { Authorization = "Bearer <your-token>" }

Cursor (IDE)

Add the following to ~/.cursor/mcp.json. Paste your token into the snippet, then restart Cursor:

{
  "mcpServers": {
    "joinbrands": {
      "type": "http",
      "url": "https://api.joinbrands.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

VS Code (IDE)

Create .vscode/mcp.json in your project (or edit your global VS Code MCP config). Paste your token into the snippet, then enable JoinBrands from the Copilot Chat tools panel:

{
  "servers": {
    "joinbrands": {
      "type": "http",
      "url": "https://api.joinbrands.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Other MCP Clients

If your MCP client supports custom HTTP headers, point the client at the MCP server URL above and send the token as a Bearer header on every request:

Authorization: Bearer <your-token>

📝 A Few Things to Keep in Mind

⚠️ Read-only for now: This first version of the MCP supports read-only access to campaigns, jobs, and job content. You won’t be able to create or edit data from your AI tool just yet.

💬 We want your feedback!
​
This is just the start. Based on how brands use the MCP, we’ll evaluate and expand what it can do over time — so please tell us what you’d like to see next.

Got more questions? The Brand & Creator Assistance Team is here for you! Send us a message!

Did this answer your question?