BOSRAI ships an MCP server (Model Context Protocol — the open standard AI assistants use to operate tools). Connect it to Claude or any MCP-capable agent and your assistant can read your pipeline, search contacts, pause campaigns, and have BOSRAI write native-language outreach — by just asking.
Connecting from Claude? Skip this step — the connector signs in with OAuth in your browser (step 2). Keys are for curl, cron jobs, and clients that can't open a browser.
bsr_live_…) is shown once; store it like a passwordThe server speaks MCP over Streamable HTTP (JSON responses), protocol 2025-06-18, with two ways in:
# Endpoint
POST https://bosr.ai/api/mcp
# Auth — one of:
# OAuth 2.1 (one-click browser sign-in; MCP clients discover it automatically)
# Authorization: Bearer bsr_live_your_key_herehttps://bosr.ai/api/mcp — leave every other field empty, no API key neededThe connection is scoped to your workspace. Disconnect any time by removing the connector in Claude, or revoke it from BOSRAI under Settings → API & MCP → Connected apps.
{
"mcpServers": {
"bosrai": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://bosr.ai/api/mcp"]
}
}
}That opens the same browser sign-in on first run. Headless (no browser)? Pass your API key instead:
"args": […, "--header", "Authorization: Bearer bsr_live_…"]
curl -s https://bosr.ai/api/mcp \
-H "Authorization: Bearer $BOSRAI_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"get_roi_report","arguments":{"days":7}}}'| Tool | What it does |
|---|---|
get_workspace_overviewREAD | Snapshot: plan, credits, counts of contacts, campaigns, cadences, audiences, mailboxes. Start here. |
get_roi_reportREAD | Proof-of-work for the last N days (default 7, max 90): sent, replies, positive replies, meetings booked, pipeline value, cost — with previous-period comparison. |
list_audiencesREAD | The workspace's audiences (ICP profiles): who it sells to, firmographics, and each audience's outreach language. |
search_contactsREAD | Search contacts by name or email substring — up to 25 matches with role, score, source, tags. |
list_campaignsREAD | Outreach campaigns with status (draft / active / paused / completed) and stats. |
set_campaign_statusWRITE | Pause or start a campaign. Takes effect immediately in the live workspace. |
build_cadenceWRITE | Have BOSRAI write a complete multi-step outreach cadence (3–6 emails) from your brand + audience context — native-fluent in the audience's language. Creates a real cadence. |
list_signal_monitorsREAD | The always-on buying-signal monitors (new store openings, hiring surges, ad launches, import records…) with per-monitor yield. |
get_upcoming_bookingsREAD | Meetings prospects have booked via your BOSRAI booking page. |
get_recent_repliesREAD | Most recent inbound prospect messages across email, LinkedIn and WhatsApp — what prospects are actually saying. |
list_skillsREAD | Catalog of 100+ executable skills — marketing, sales and ops playbooks (blog writer, SEO pipeline, social posts, ad copy, competitor monitors, email sequences, …) with each skill's required inputs. |
run_skillWRITE | Execute any cataloged skill by slug. Costs that skill's credits, respects your plan tier and rate limits. Asynchronous — returns a task_id. |
get_skill_resultREAD | Status and output of a run_skill task: running · completed · failed. |
set_campaign_status, build_cadence and run_skill change the live workspace (and spend credits) the moment they run — same as clicking the button in the app. Point your agent at a test workspace first if you're experimenting.application/json body. No SSE stream; GET returns 405 so clients fall back to request/response. JSON-RPC batching is not supported (per protocol 2025-06-18).tools/list.get_roi_reportlist_campaigns → set_campaign_statusbuild_cadence with icp_id + themeget_recent_replies → summarize