01 · GETTING STARTED

Add to your agent

Choose your client first. OAuth clients sign in; key-auth clients receive a reveal-once key. GTMRouter exposes 18 MCP tools.

Choose the right authentication

Claude and ChatGPT use your GTMRouter account through OAuth. Claude Code, Codex, Cursor and other key-auth clients use a key created in Setup. Never put a key into a public repository.

Claude

Claude on the web or desktop signs you in with your GTMRouter account. There is no key to paste and no header to set.

Open Settings → Connectors and choose Add custom connector.
Name it GTMRouter and paste the MCP server URL below.
Choose Add. Claude sends you to GTMRouter to approve access — sign in and you are connected.

MCP server URL

https://mcp.gtmrouter.dev/mcp

The free Claude plan allows one custom connector. Connectors can't be added from the mobile app — set it up on web or desktop and it is available on your phone. Verified in a live account on 2026-09-11.

Or paste this into Claude

prompt

I want to add GTMRouter as a custom connector. You can't add it yourself, so walk me through it one step at a time and wait for me to confirm each: 1) Settings → Connectors → Add custom connector. 2) Name it GTMRouter, URL https://mcp.gtmrouter.dev/mcp, choose Add. 3) Approve access when I'm sent to GTMRouter. Then check the GTMRouter tools are available in this chat.

Claude can't add connectors to itself — this prompt has it guide you through the three steps above.

ChatGPT

ChatGPT signs you in with your GTMRouter account. The switch lives under Security, not Apps — that is the step everyone misses.

💡 Using ChatGPT Plus or Pro? Codex gives you the full experience. ChatGPT applies its own safety filters to connected tools and can refuse enrichment or outreach steps — that is outside GTMRouter’s control. Codex, OpenAI’s agent for developers, is included with paid ChatGPT plans, runs the same fifteen tools without those refusals, and is a one-block setup. Set up Codex instead →

Open Settings → Security and login and turn on Developer mode.
Go to Plugins (chatgpt.com/plugins) and choose +.
Name it GTMRouter, add a short description, and under Connection paste the MCP server URL below. Choose Create.
Approve access when ChatGPT sends you to GTMRouter — sign in and it is connected.
In a new chat, open the tools menu and add GTMRouter.

MCP server URL

https://mcp.gtmrouter.dev/mcp

Available on paid plans on the web; availability can depend on your plan and workspace policy. There is no API-key option in ChatGPT — it signs in with OAuth. Verified in a live account on 2026-09-11.

Or paste this into ChatGPT

prompt

I want to add GTMRouter as a custom MCP plugin. You can't add it yourself, so walk me through it one step at a time and wait for me to confirm each: 1) Settings → Security and login → turn on Developer mode. 2) Go to Plugins and choose +. 3) Name it GTMRouter, add a description, and under Connection paste https://mcp.gtmrouter.dev/mcp, then Create. 4) Approve access when I'm sent to GTMRouter. 5) In a new chat, open the tools menu and add GTMRouter. Then check the GTMRouter tools are available.

ChatGPT can't add plugins to itself — this prompt has it guide you through the five steps above.

Claude Code

One command in your terminal. Your key is already in it.

Paste this into your terminal and press enter. If the server does not appear straight away, restart Claude Code.

configuration

claude mcp add --transport http gtmrouter https://mcp.gtmrouter.dev/mcp \
  --header "Authorization: Bearer YOUR_GTMROUTER_API_KEY"

Or paste this into Claude Code

prompt

Add the GTMRouter MCP server to this project. Run: claude mcp add --transport http gtmrouter https://mcp.gtmrouter.dev/mcp --header "Authorization: Bearer YOUR_GTMROUTER_API_KEY" — then run claude mcp list and confirm gtmrouter is connected.

Codex

Codex reads MCP servers from a config file. Add this block and it is connected on the next run.

Open ~/.codex/config.toml (create it if it does not exist), paste this at the end, then start a new Codex session.

configuration

[mcp_servers.gtmrouter]
url = "https://mcp.gtmrouter.dev/mcp"
http_headers = { "Authorization" = "Bearer YOUR_GTMROUTER_API_KEY" }

Or paste this into Codex

prompt

Add the GTMRouter MCP server to my Codex config. Append this to ~/.codex/config.toml (create the file if needed):
[mcp_servers.gtmrouter]
url = "https://mcp.gtmrouter.dev/mcp"
http_headers = { "Authorization" = "Bearer YOUR_GTMROUTER_API_KEY" }
Then confirm it loads and list the gtmrouter tools.

Cursor

Cursor reads MCP servers from mcp.json. Project-level or global, your choice.

Paste this into .cursor/mcp.json in your project, or ~/.cursor/mcp.json for every project.

configuration

{
  "mcpServers": {
    "gtmrouter": {
      "url": "https://mcp.gtmrouter.dev/mcp",
      "headers": { "Authorization": "Bearer YOUR_GTMROUTER_API_KEY" }
    }
  }
}

Or paste this into Cursor

prompt

Add the GTMRouter MCP server to this project. Write this to .cursor/mcp.json (merge if the file exists):
{"mcpServers":{"gtmrouter":{"url":"https://mcp.gtmrouter.dev/mcp","headers":{"Authorization":"Bearer YOUR_GTMROUTER_API_KEY"}}}}
Then confirm the gtmrouter tools are available.

Other

n8n, a custom agent, your own SDK loop — anything that speaks MCP over streamable HTTP. Two values.

Give your client the server URL and this header. If it supports OAuth instead, use the URL alone and sign in.

configuration

URL:     https://mcp.gtmrouter.dev/mcp
Header:  Authorization: Bearer YOUR_GTMROUTER_API_KEY

Or paste this into your agent

prompt

Connect to the MCP server at https://mcp.gtmrouter.dev/mcp using the header Authorization: Bearer YOUR_GTMROUTER_API_KEY — or, if you support OAuth, connect with the URL alone and sign in. Then confirm the connection and list the available tools.

The 18 tools

Tool	Role
find_leads	Run a GTM outcome
find_companies	Run a GTM outcome
find_intent	Run a GTM outcome
find_posts	Run a GTM outcome
enrich	Run a GTM outcome
enrich_company	Run a GTM outcome
verify_email	Run a GTM outcome
setup_sending	Run a GTM outcome
create_campaign	Run a GTM outcome
add_leads	Run a GTM outcome
launch_campaign	Run a GTM outcome
get_replies	Run a GTM outcome
get_usage	Read account or request state
get_operation	Read account or request state
get_request	Read account or request state
get_reply	Run a GTM outcome
set_lead_status	Run a GTM outcome
reply_to_thread	Run a GTM outcome

🛡️ Sending actions remain human-controlled. Approval authorizes your agent to retry the same action; the console does not execute it.

Try it safely

Once connected, paste this into your agent:

prompt

Find me 50 healthcare executives in the US, enrich the three most promising into verified emails, and check those emails for deliverability. Summarize the usable leads and total credits spent. Do not create or launch a campaign.