Connect Claude, Cursor or any MCP client, and your agent can do in GEOboom what you do in the app: set up projects and campaigns, find prospects, decide them, launch, answer publishers and write deals down. It works through the same operations the app uses, so it sees what you see and is held to the same rules.
Connect
The server is at https://api.geoboom.io/mcp. Add it to your client, sign in to GEOboom when it asks, choose the organisation and what the agent may do, and its tools appear.
Claude Code
claude mcp add --transport http geoboom https://api.geoboom.io/mcpThen run /mcp, pick geoboom and choose Authenticate. A browser opens to sign in and approve.
Claude
In Settings → Connectors, choose Add custom connector, name it GEOboom and paste https://api.geoboom.io/mcp. Connect, sign in, approve.
Cursor
Add it to ~/.cursor/mcp.json:
{
"mcpServers": {
"geoboom": { "url": "https://api.geoboom.io/mcp" }
}
}Any other client
The server speaks MCP over Streamable HTTP, without sessions, and signs agents in with OAuth 2.1 (PKCE, client ID metadata documents or dynamic registration). A client that cannot sign in can send an API key instead, made by an owner in Settings → Integrations:
claude mcp add --transport http geoboom https://api.geoboom.io/mcp \
--header "Authorization: Bearer gbk_..."What an agent may do
Only an owner of the organisation can approve a connection. They choose what it may do, and sending and spending start unticked:
| Scope | Allows |
|---|---|
read | See everything: projects, campaigns, prospects, publishers, contacts, deals and the inbox, threads included. |
campaigns:write | Create and change projects and campaigns, set up prospecting, import URLs and decide which fit, edit drafts. |
prospecting:spend | Spend: run prospecting, set monthly credit budgets, turn on automatic scheduling. |
mail:send | Reach publishers: reply on threads, send first emails, launch or resume a campaign. Sent email cannot be taken back. |
deals:write | Write deals down: terms, prices, paid, placements and whether they are live. |
Some things stay with people in the app, whatever the scopes: inviting and removing members, making or widening keys and connections, deleting projects and campaigns, and billing. Archiving and pausing are allowed; deleting is not.
Sending and spending
A tool that reaches a person outside GEOboom or commits credits takes a required idempotency_key argument. The agent makes one per intended action, a UUID is ideal, and passes the same one if it retries. A retry then gets the first call's answer instead of a second email or a second charge.
GEOboom also checks the thing itself, whatever the key: a reply identical to one sent on the same thread in the last 24 hours is refused, and so is a reply when a message arrived after the one the agent says it read (seenMessageId), so it answers what the publisher actually said.
Some tools ask before they commit: campaigns_resume and drafts_send answer with the cost first when there is one, and go ahead when called again with it agreed. Your client shows which tools only read and which reach outside, and most ask you before running the second kind.
Long work
Prospecting takes minutes. prospecting_run returns at once with a jobId; the agent follows it with jobs_get and reads the run's progress with prospecting_latestRun. The prospects it found are then in prospects_list.
When a tool refuses
A refusal comes back as a tool error whose text says what was wrong in plain words: a missing permission, no credits, something not found in this organisation. The error codes are the same as the API's.
A first session
What an agent does to take a brand from nothing to agreed placements:
org_get: credits available and whether the organisation is activated.projects_createfor the brand, thencampaigns_createin it. A campaign starts paused and empty.prospecting_saveKeywordswith the searches the brand's buyers make (orprospecting_savePromptswith the questions they ask AI),prospecting_setModeto make it the campaign's source, andprospecting_run. Or bring your own list withprospects_import.jobs_getuntil the run is done, thenprospects_listto see the pages found, most valuable first.prospects_setVerdictto mark the fits, orprospects_planAutoFilterandprospects_autoFilterto let the campaign's rules decide. Fits are searched for contacts.campaigns_resumeto launch: first emails go from the project's mailboxes on their schedule.threads_listwithtab: "need_action"for the replies that need an answer,threads_getto read one, andthreads_replyto answer.- When terms are agreed:
deals_create,deals_updatewith the price,deals_addPlacementfor what goes where, anddeals_updatePlacementto mark it live. GEOboom checks live placements every day;deals_listshows which are still as agreed.
Every tool is listed, with its inputs, in the API reference: each operation there is a tool, named with an underscore (deals.create is deals_create).