Use with Claude or Codex

Find your next customers from Claude Code or Codex.

Search BuyerCue, review the evidence, and draft outreach without leaving your assistant. Every company comes with the sourced, dated evidence that it pays for growth, plus its public business contact routes.

BuyerCue MCP server

One URL, any supported app

Remote MCP · OAuth
https://www.buyercue.io/mcp

Works with apps that support remote MCP over HTTP with OAuth sign-in. There are no API keys to paste: you sign in to BuyerCue in your browser.

No account yet? New accounts get 5 free tokens. Sign in and connect

You stay in control

  • You approve access

    Each app signs in through BuyerCue. Reading is on by default; unlocking is off until you tick it.

  • You set the daily limit

    Each app gets its own daily BuyerCue token limit. A chat message can lower it for one request, never raise it.

  • It can't buy tokens

    Unlocks come from your existing balance, at 1 token per new company. Tokens are only bought by you, on BuyerCue.

  • You send the outreach

    Your assistant drafts. BuyerCue never contacts anyone, and you review and send every message yourself.

Setup 1 of 3

Claude Code

Terminal, VS Code and JetBrains extensions, and the desktop app's Code tab.

Our testing: Connected end to end on October 11, 2026 for the walkthrough video.

  1. 1

    Add the server

    Run this in your terminal. Add --scope user to use BuyerCue in every project, not just the current one.

    claude mcp add --transport http buyercue https://www.buyercue.io/mcp
    • Adding the server does not sign you in. Until you do, claude mcp list shows it as “Needs authentication”.
  2. 2

    Sign in with OAuth

    Inside Claude Code, run /mcp, pick buyercue and choose to authenticate. Or start the sign-in from your shell:

    claude mcp login buyercue
    • Your browser opens BuyerCue. Sign in, then choose whether this app may unlock leads and set its daily token limit.
    • No browser on this machine? The command prints a URL. Open it elsewhere, then paste the full redirect URL back into the terminal.
  3. 3

    Check the connection

    buyercue should now show “✔ Connected” instead of “! Needs authentication”. Then ask the harmless check below.

    claude mcp list
    Ask your assistant
    Use the BuyerCue get_account tool to check my connection. Don't search or unlock anything.

    Expected answer · no tokens spent

    • Your BuyerCue token balance and how many companies you have unlocked
    • The permissions you approved: buyercue:read, plus buyercue:unlock if you allowed unlocking
    • This app's daily token limit and how much is left today: 0 if you approved reading only (resets at 00:00 UTC)
    • A link to manage the connection on BuyerCue
  4. 4

    Ask for customers

    Start with a free search, then decide what to unlock. Copy a first prompt.

    Disconnect

    Sign out first so the grant is revoked on BuyerCue, then remove the server. Removing alone deletes the local tokens but does not revoke them.

    claude mcp logout buyercue
    claude mcp remove buyercue

Setup 2 of 3

Codex

Codex CLI, IDE extension and desktop app. They share one MCP configuration.

Our testing: Checked November 8, 2026 with Codex CLI 0.166: adding the server starts sign-in and BuyerCue's approval returns to Codex. A full Codex session against BuyerCue hasn't been run yet. Tell us if a step doesn't match.

  1. 1

    Add the server

    Run this in your terminal. Codex detects that BuyerCue uses OAuth and starts the sign-in straight away, printing a sign-in link. Or add the table to ~/.codex/config.toml yourself.

    codex mcp add buyercue --url https://www.buyercue.io/mcp
    ~/.codex/config.toml
    [mcp_servers.buyercue]
    url = "https://www.buyercue.io/mcp"
  2. 2

    Sign in with OAuth

    Open the sign-in link Codex printed if your browser didn't open it. If you closed it, or added the server through config.toml, start the sign-in again:

    codex mcp login buyercue
    • In the IDE extension or desktop app, open the MCP server list (/mcp) and select Authenticate next to buyercue.
    • On BuyerCue, sign in, then choose whether this app may unlock leads and set its daily token limit.
    • No local browser? Add --no-browser, open the printed URL elsewhere and paste the full redirect URL back.
  3. 3

    Check the connection

    Before sign-in, the Auth column for buyercue reads “Not logged in”; afterwards it shows you’re signed in. In a Codex session, /mcp shows its four tools. Then ask the harmless check below.

    codex mcp list
    Ask your assistant
    Use the BuyerCue get_account tool to check my connection. Don't search or unlock anything.

    Expected answer · no tokens spent

    • Your BuyerCue token balance and how many companies you have unlocked
    • The permissions you approved: buyercue:read, plus buyercue:unlock if you allowed unlocking
    • This app's daily token limit and how much is left today: 0 if you approved reading only (resets at 00:00 UTC)
    • A link to manage the connection on BuyerCue
  4. 4

    Ask for customers

    Start with a free search, then decide what to unlock. Copy a first prompt.

    Disconnect

    Sign out, then remove the server from your configuration.

    codex mcp logout buyercue
    codex mcp remove buyercue

Setup 3 of 3

Claude (chat)

claude.ai, the Claude desktop app and Cowork, as a custom connector.

Our testing: Tested November 8, 2026 on claude.ai (Pro): added the connector, signed in, checked the account and ranked companies without spending tokens. Unlocking from Claude chat hasn't been tested yet.

  1. 1

    Add a custom connector

    Custom connectors are available on every Claude plan. Free plans can add one.

    • Open Customize › Connectors, select + Add, then Add custom connector.
    • Name it BuyerCue and paste the server URL: https://www.buyercue.io/mcp. Select Continue.
    • Keep the detected settings (Sign in now, Register automatically), then select Add.
    • On the connector's page, select Connect.
    • Team or Enterprise: an Owner adds it under Organization settings › Connectors, then each member selects Connect.
  2. 2

    Sign in with OAuth

    Claude opens BuyerCue. Sign in, then choose whether Claude may unlock leads and set its daily token limit. Claude never sees your BuyerCue password.

    • In a chat, select + › Connectors and make sure BuyerCue is switched on for that conversation.
  3. 3

    Check the connection

    Start a new chat with BuyerCue switched on and ask the harmless check below.

    Ask your assistant
    Use the BuyerCue get_account tool to check my connection. Don't search or unlock anything.

    Expected answer · no tokens spent

    • Your BuyerCue token balance and how many companies you have unlocked
    • The permissions you approved: buyercue:read, plus buyercue:unlock if you allowed unlocking
    • This app's daily token limit and how much is left today: 0 if you approved reading only (resets at 00:00 UTC)
    • A link to manage the connection on BuyerCue
  4. 4

    Ask for customers

    Start with a free search, then decide what to unlock. Copy a first prompt.

    Disconnect

    Open Customize › Connectors, select the ••• next to BuyerCue, then Remove. To pause it for one chat, switch it off under + › Connectors instead.

Optional · Claude Code and Codex plugin

Add the BuyerCue skills.

The plugin bundles the same server with two skills that teach your assistant BuyerCue's workflow and rules. Install it instead of adding the server by hand, not as well, or you'll have two copies of the same tools.

  • rank-buyercue-companies

    Searches previews for free, ranks them against your offer with reasons and unknowns, and unlocks only when you ask, within the budget you give.

  • draft-buyercue-outreach

    Drafts a first email, form message or DM for companies you've unlocked, using only their listed business routes and cited evidence.

View the source on GitHub

Claude Code

claude plugin marketplace add apsquared/buyercue-plugin
claude plugin install buyercue@buyercue

Codex

codex plugin marketplace add apsquared/buyercue-plugin
codex plugin add buyercue@buyercue

Installing doesn't sign you in. Next, follow step 2 for Claude Code or Codex. In Claude Code the server is listed as plugin:buyercue:buyercue; pick that one in /mcp. Claude chat doesn't use this plugin: add the connector instead.

Useful first prompts

Rank for free. Unlock what fits.

Searching costs nothing: your assistant judges fit from previews that hide each company's identity. Unlocking costs 1 token per new company, within the daily limit you approved. Drafts stay drafts until you send them.

  1. 1. Rank against your offer (free)

    I sell [your product] to [who it's for]. Search BuyerCue for 15 new companies that could fit, rank them by fit using only the preview evidence, and say what's unknown for each. Don't unlock anything.
  2. 2. Unlock a few and draft outreach

    Unlock the top 3 from that list, spending at most 3 BuyerCue tokens. For each, draft a short first message for its best public business contact route, using only the sourced evidence. I'll review and send them myself.

Connection or copy-and-paste?

BuyerCue works with AI two ways. They're separate features, and you can use both.

MCP connection · this page

A live link your assistant keeps

  • Set up once per app, with an OAuth sign-in
  • Searches all of BuyerCue, not just your leads
  • Can unlock companies within the daily limit you set
  • Always reads current data
  • Needs an app that supports remote MCP with OAuth

Use with AI · export

A prompt you paste anywhere

  • Built from My leads or an unlocked company, in one click
  • Covers only companies you already own
  • Never searches or unlocks, and spends no tokens
  • A snapshot as of the moment you copy it
  • Works in any chatbot, no connection needed
How Use with AI works

Troubleshooting

“Needs authentication”, or no BuyerCue tools appear

Adding the server doesn't sign you in. Run your client's sign-in step, then start a new session or chat.

The browser didn't open

Copy the sign-in URL your client prints and open it yourself. On a remote machine, use the --no-browser option and paste the redirect URL back.

Sign-in fails or loops

Check the URL is exactly the server URL shown here, ending in /mcp. Then remove the server, add it again and sign in again so your client registers afresh.

“reconnect_with_unlock_permission”

You approved reading only. Disconnect the app on BuyerCue, sign in again from your client and tick “Allow this app to unlock more leads using my tokens”.

Unlocks stop or spend 0 tokens

This app's daily limit is used up, or your balance is empty. Raise the limit in Connected apps, wait for the 00:00 UTC reset, or buy tokens yourself on BuyerCue. The assistant can't buy tokens.

“not_owned_or_unavailable”

Full details are only for companies you've unlocked. A company that asked not to be contacted, or left the index, stays unavailable even if you own it.

Asked to sign in again after a while

Sign-ins last 30 days without use, and disconnecting on BuyerCue ends them immediately. Run your client's sign-in step again.

Still stuck? Contact us with your app's name and the error it shows.