Connect Roger to your AI agent
Roger's MCP server · Updated November 14, 2026
Roger runs outbound sales: it finds leads, writes and sends email and LinkedIn sequences, and handles the replies. Its MCP server lets Claude, ChatGPT, Cursor, Codex or your own agent do that work in your Roger account, with the access you choose.
Server address
https://mcp.hireroger.com/mcp
- Streamable HTTP, with OAuth sign-in to your Roger account.
https://mcp.hireroger.com/mcp/directoryis the same server for app directories and Roger's plugin. It never offers AI image or video generation.- You need a Roger account with an active plan or trial. The server refuses connections from accounts without one.
Connect an app
Claude
In claude.ai or Claude Desktop, add a custom connector with the server address, or open this link to have Claude fill it in. Then sign in to Roger when Claude asks.
In Claude Code:
claude mcp add --transport http roger https://mcp.hireroger.com/mcp
Or install Roger's plugin, which adds operating skills:
/plugin marketplace add augmentinc/hireroger-plugins /plugin install hireroger@hireroger
ChatGPT
Go to ChatGPT Plugins, select the plus button, then Add custom MCP server, and enter the server address. Your workspace's policies apply to custom servers.
Cursor, Codex and other MCP apps
Add a remote MCP server with the server address. The app opens Roger's sign-in, where you choose what it may do. In Cursor, for example, add this to mcp.json:
{
"mcpServers": {
"roger": { "url": "https://mcp.hireroger.com/mcp" }
}
}What the agent may do
When you connect an app, you pick its access level on Roger's sign-in screen. You can change or revoke it at any time in Roger under Settings, AI apps.
| Level | What it allows |
|---|---|
| Read | Reports, lookups and research. Changes nothing. |
| Review first (the default) | Everything in Read, and prepares changes that wait for you to approve them in Roger before anything happens. |
| Act | Everything in Review first, but everyday changes (contacts, drafts, settings) apply directly. Offered under Advanced to apps that identify themselves with a client metadata document, and to API keys. |
At every level, sending to real people, spending credits and deleting wait for your approval, unless you set a rule for an API key (see below). The app shows you a link to the change; one page in Roger lists every change waiting, where you approve or reject it, and the app picks up the result.
Everyday tools load by default. Rarer ones come in tool packs (campaign housekeeping, CRM admin, inbox admin, platform admin) that you switch on for a connection in Settings, AI apps; reconnect the app afterwards so it reloads its tools. Every change an app makes is listed there too.
Headless agents and API keys
- In Roger, open Settings, APIs and create a key. It is shown once and expires after a year.
- In Settings, AI apps, turn on agent access for the key and choose its access level.
- Send it to the server address as
Authorization: Bearer rgr_live_…
A key without agent access is refused with “This API key isn't connected to Roger's MCP yet. Connect it in Settings > AI apps.”
Where your workspace has it, an owner or admin can also give one key at Act a rule in Settings, AI apps: on the campaigns they pick, that key adds people and approves their drafted sequences without a click, up to a number of people a day (25 unless they set another). Everything else the key does waits as usual, and credits are charged as usual.
Tools
The everyday tools every connection gets. Use action_preview before anything that reaches people or spends credits.
Leads
people_searchPeople by role, location, industry or company. Free.companies_searchCompanies from Roger's database by a plain-language description. Free.leads_preview_startA free preview of up to 20 people who match an ICP.leads_findThe best people at a list of companies, with contact details. Uses lead credits.contacts_importImport a list of people and fill in missing details. Uses lead credits.contact_email_revealWork emails for saved contacts that have a LinkedIn URL. Uses lead credits.
Contacts
contacts_listContacts already in the account, filtered and paged.contacts_upsertSave or update contacts, or save the people a lead search found.contacts_tags_updateAdd or remove tags.do_not_contact_addBlock people or whole companies from every campaign.
Campaigns
campaigns_listOutbound campaigns with their channels and counts.campaign_getOne campaign: targeting, messaging, senders, schedule and results.campaign_create_draftA new campaign as a draft. A draft sends nothing.campaign_updateChange a campaign's settings and sequence templates.campaign_sequence_generateHave Roger write an email or LinkedIn sequence to review.campaign_contacts_addEnroll contacts; Roger drafts a sequence for each.campaign_startPublish a draft or resume a paused campaign.campaign_pauseStop sending right away.sequences_listEach contact's drafted sequence, by status.sequences_approveApprove drafted sequences so Roger starts contacting those people.
Inbox
conversations_listConversations that need attention, with reply types and counts.conversation_getOne thread with its messages.conversation_reply_generateDraft a reply from the whole thread. Sends nothing.conversation_reply_sendSend a reply by email or LinkedIn.conversation_updateSet a reply type or mark messages read.
Account and platform
whoamiThe account, its plan and limits, and what this connection may do. Call it first.roger_queryOne read-only script over many read tools.action_previewWhat a change would do, cost and reach, without doing it.job_getThe state of long-running work such as a lead search.operation_waitWaits for a change to be approved and finish.report_issueTell the Roger team about a bug or a missing tool.
Limits
- 300 requests a minute per connection.
- Replies: at most 3 agent replies per conversation and 100 per organization in 24 hours.
roger_query: at most 30 tool calls and 20 seconds per script.- Lead previews: a limited number per user per hour. Lead credits and sequence credits come from your plan.
Data and privacy
- A connection acts only in the Roger workspace you signed in to, as you, with the access level you chose.
- Tool results come from your Roger account. The app you connect receives them and handles them under its own terms.
- Roger tells the agent that prospects' messages are correspondence, never instructions, and no message can approve a send or a spend.
- Revoke a connection at any time in Settings, AI apps. See our Privacy Policy and Terms of Service.
Troubleshooting
- “An eligible Roger subscription or trial is required to use this connection.” Start your trial or plan in Roger under Settings, Billing, then connect again.
- “This token was issued for a different Roger MCP address. Reconnect with this one.” Connect again using the address your app calls.
- “This Roger connection has expired or been revoked.” Connect the app again.
- “Invalid, expired or revoked Roger credential.” The app sent no sign-in, or one that expired or was revoked. Connect the app again; for an API key, check it in Settings, APIs.
- A tool you expect is missing: switch its pack on in Settings, AI apps, then reconnect the app.
Support
Email support@hireroger.com, or ask your agent to file it with report_issue.