You pay for what you connect. Nothing else.
$1 a month per connected account
A SwooshRank product — sign-up and your client's consent screen both carry that name.
Using an AI agent? Copy a setup prompt.
Connect to the SwooshConnect MCP server at https://swooshrank.com/api/mcp using this config: claude mcp add --transport http swooshconnect https://swooshrank.com/api/mcp --header "Authorization: Bearer <your key>" Replace <your key> with my real API key, then call list_accounts and tell me what you find.
Connect to the SwooshConnect MCP server at https://swooshrank.com/api/mcp using this config: [mcp_servers.swooshconnect] url = "https://swooshrank.com/api/mcp" bearer_token_env_var = "SWOOSHCONNECT_API_KEY" Replace <your key> with my real API key, then call list_accounts and tell me what you find.
Connect to the SwooshConnect MCP server at https://swooshrank.com/api/mcp using this config:
{
"mcpServers": {
"swooshconnect": {
"url": "https://swooshrank.com/api/mcp",
"headers": {
"Authorization": "Bearer <your key>"
}
}
}
}
Replace <your key> with my real API key, then call list_accounts and tell me what you find.claude mcp add --transport http \
swooshconnect \
https://swooshrank.com/api/mcp \
--header "Authorization: Bearer <your key>"{
"accounts": [
{
"accountId": "9f2c41e8-5a7b-4c1d-9e03-6f81b2a4c7d5",
"provider": "google_business",
"label": "Nona's Bakery",
"name": "Nona's Bakery — Camden",
"status": "connected",
"locked": false,
"connectedAt": "2026-09-21T09:14:02.000Z"
}
],
"pendingInvites": [],
"billing": {
"connected": 1,
"free": 2,
"billable": 0,
"needsPayment": false,
"frozen": false,
"complimentary": false
}
}The same request and response shape every time — an account id, the field the tool needs, and the fields it hands back.
create_postOne call, any platform below that takes a post.
Live on Google Business Profile, Facebook Page, Instagram, TikTok
{
"accountId": "<uuid>",
"text": "Doors open at seven."
}{
"postId": "3f9e2a7b-6c1d-4b8a-9e02-7d5f4c3b2a19",
"permalink": "https://example.com/p/3f9e2a7b"
}list_reviews + reply_reviewRead what came in, then reply to the ones worth answering.
Live on Google Business Profile, Facebook Page
{
"accountId": "<uuid>"
}{
"reviews": [
{
"reviewId": "6b1f9c2e-4a7d-4e11-9c8a-2f5e7d3b1a06",
"author": "Priya S.",
"rating": 5,
"text": "Best bread in town.",
"date": "2026-09-18T16:40:00.000Z"
}
]
}get_insightsThe last four weeks, the same shape on every platform.
Live on Google Business Profile, Facebook Page, Instagram, TikTok, Google Analytics
{
"accountId": "<uuid>",
"range": "28d"
}{
"range": {
"startDate": "2026-08-24",
"endDate": "2026-09-21"
},
"metrics": [
{
"key": "views",
"label": "Profile views",
"total": 1842,
"points": [
{
"date": "2026-09-21",
"value": 96
}
]
}
]
}One HTTP endpoint and one bearer header. Three clients have a written quickstart; every other MCP client reaches the same server today with no connector to install.
Set up from a written page: copy one line, paste your key, done.
Any client that speaks MCP over HTTP with a bearer header reaches the same endpoint today. Nothing to install.
No native connector from us yet. Each of these can already call the REST API like any other HTTP service.
Each platform below is connected by the account's own owner, and the agent works inside exactly the access that owner granted.
| Platform | Connect | Post | Reviews | Replies | Insights | Detail |
|---|---|---|---|---|---|---|
| Google Business Profile | Yes | Yes | Yes | Yes | Yes | Detail for Google Business Profile |
| Facebook Page | Yes | Yes | Yes | Yes | Yes | Detail for Facebook Page |
| Yes | Yes | No | No | Yes | Detail for Instagram | |
| TikTokPosts need an image or video URL — text alone is refused. | Yes | Yes | No | No | Yes | Detail for TikTok |
| Google Analytics | Yes | No | No | No | Yes | Detail for Google Analytics |
| SupabaseConnect and list today; no posting, reviews or insights tools on this platform yet. | Yes | No | No | No | No | Detail for Supabase |
| AI model keyConnect and list today; no posting, reviews or insights tools on this platform yet. | Yes | No | No | No | No | Detail for AI model key |
An agent learns this surface once. Adding a platform adds accounts, never a new tool and never a new shape to handle.
connect_accountCreate a single-use link for a customer's client to connect one of their social or Google Business accounts.
Call: connect_account { provider: "google_business", label: "Nona's Bakery", maxAccounts: 4 }list_accountsList every account connected so far, any pending connect invites, and the current billing position.
Call: list_accounts { }create_postPublish a post (text, and optionally an image or a link) to a connected account.
Call: create_post { accountId, text: "Doors open at seven." }list_reviewsList reviews left on a connected account, newest information first.
Call: list_reviews { accountId }reply_reviewPost a reply to one review on a connected account.
Call: reply_review { accountId, reviewId, text: "Thanks — see you soon." }get_insightsGet performance metrics for a connected account over a recent date range.
Call: get_insights { accountId, range: "28d" }inbox_listList everything that has come in on a connected account — reviews and comments — newest first.
Call: inbox_list { accountId }inbox_replyPost a reply to one inbox item (a review or a comment) on a connected account.
Call: inbox_reply { accountId, itemId, text: "Thanks — see you soon." }calendar_upcomingList the owner's next events on a connected calendar, soonest first.
Call: calendar_upcoming { accountId }calendar_slotsFind open booking slots on a connected calendar over the next few days.
Call: calendar_slots { accountId, days: 7 }calendar_bookBook a new appointment on the owner's real calendar. This changes their calendar.
Call: calendar_book { accountId, start: "2026-10-01T14:00:00Z", end: "2026-10-01T14:30:00Z", leadName: "Jordan Rivera" }calendar_moveReschedule an existing appointment on the owner's real calendar. This changes their calendar.
Call: calendar_move { accountId, eventId, start: "2026-10-01T15:00:00Z", end: "2026-10-01T15:30:00Z" }calendar_cancelCancel an existing appointment on the owner's real calendar. This changes their calendar.
Call: calendar_cancel { accountId, eventId }customers_listList the owner's contacts on a connected customer list.
Call: customers_list { accountId }customers_findFind one contact on a connected customer list by name, email, or phone.
Call: customers_find { accountId, q: "Jordan Rivera" }agents_catalogList the agent templates available to deploy.
Call: agents_catalog { }agents_listList the agents already deployed for this organization.
Call: agents_list { }agents_targetsList the projects an agent can be deployed onto for a connected runtime account.
Call: agents_targets { runtimeAccountId }agents_deployDeploy an agent template onto a connected runtime project. Deploying creates an API key for this agent; that key lets it reply and post on your connected accounts.
Call: agents_deploy { templateId: "review-reply", runtimeAccountId, runtimeTarget, secrets: { AI_MODEL_PROVIDER: "anthropic", AI_MODEL_KEY: "…" } }agents_statusGet the current status of one agent deployment.
Call: agents_status { deploymentId }agents_removeTear down an agent deployment and revoke its API key.
Call: agents_remove { deploymentId }calls_numbersList the active phone numbers on a connected phone account — the caller ids a dialer campaign can use.
Call: calls_numbers { accountId }dialer_campaignsList this organization's dialer campaigns with their settings and how many contacts are pending, done, or on the do-not-call list.
Call: dialer_campaigns { }dialer_save_campaignCreate a dialer campaign, or update one by id: caller id, lines per agent (1, 2, 3 or 5), ring timeout, wrap-up pause, calling hours and time zone, and retry rules. mode "human" (the default) is dialed only by a person on the dialer screen. mode "ai" is dialed only by our automated caller, only to contacts with recorded consent, within calling hours and the required daily limit (maxCallsPerDay, 1 to 500); it needs aiSettings with the business name and the reason for the call. A field left out keeps its saved value.
Call: dialer_save_campaign { name: "Spring list", accountId, fromNumber: "+15551234567", lines: 1, hoursStart: "09:00", hoursEnd: "20:00", … }dialer_import_contactsAdd contacts to a dialer campaign, either as CSV text (name, phone, optional timezone, ai_consent, consent_source, consent_text, consent_at columns) or as rows. A row's consent to automated calls (aiConsent express or written) needs a consentSource and, when given, a past consentAt; a row that claims consent without them is imported with no consent and counted in consentRejected. Numbers on the do-not-call list, duplicates and invalid numbers are skipped and counted.
Call: dialer_import_contacts { campaignId, csv: "name,phone\nJordan Rivera,+15551234567" }dialer_add_dncAdd a phone number to this organization's do-not-call list. It is never dialed again from any campaign.
Call: dialer_add_dnc { phone: "+15551234567" }dialer_set_consentRecord whether a dialer contact agreed to automated calls (none, express or written), with where that consent came from and, optionally, its wording. Only a contact with express or written consent can be called by an AI campaign.
Call: dialer_set_consent { contactId, level: "written", source: "Signed intake form" }calls_logList the calls our assistant handled on this organization's phone accounts: inbound calls it answered and outbound AI campaign calls, with the other party's number, the contact, the outcome (outbound only), consent, transfer, opt-out and summary. To poll: Start with an ISO `since` (e.g. now) and pass back `nextCursor`; each call then arrives exactly once, oldest end first, only after it ENDED and has been over for five minutes, so its outcome is final. nextCursor is the position of the last call returned ("<endedAt ISO>|<id>"), or null when nothing new arrived: keep your previous cursor then. At most limit calls per page (default 50, max 200). For a one-off look, without `since` you get a newest-first snapshot and calls may repeat between snapshots; it includes calls still in progress. The summary may arrive a few minutes after the call ends; poll again, with a snapshot or a since before that call's end, to pick it up.
Call: calls_log { since: nextCursor, limit: 50 }voice_settings_getGet the AI receptionist settings for a connected phone account: whether it answers, the number it answers, the transfer number, business hours, greeting and instructions. settings is null when it was never set up.
Call: voice_settings_get { accountId }voice_settings_saveSave the AI receptionist settings for a connected phone account. Enabling it routes the chosen number to the receptionist; disabling it routes the number back to where it rang before. routingWarning is set when a number could not be routed back and needs fixing on the phone account.
Call: voice_settings_save { accountId, enabled: true, inboundNumber: "+15551234567", hoursStart: "09:00", hoursEnd: "18:00", … }Point an AI client at one endpoint and hand it one key. It can reach every account your clients have connected, on every platform below.
Or call the API directly. It returns a link: send it to your client, and they authorize their own account on the provider's own consent screen.
curl -X POST "https://swooshrank.com/api/v1/connect/accounts" \
-H "Authorization: Bearer <your key>" \
-H "Content-Type: application/json" \
-d '{"provider": "google_business", "label": "Nona's Bakery"}'An AI agent reaches every tool over MCP. Anything else calls the identical operation over plain REST.
One HTTP transport, one bearer header, every tool in any MCP client.
https://swooshrank.com/api/mcp
Authorization: Bearer <your key>curl -X POST "https://swooshrank.com/api/v1/connect/accounts" \
-H "Authorization: Bearer <your key>" \
-H "Content-Type: application/json" \
-d '{"provider": "google_business", "label": "Nona's Bakery"}'await fetch("https://swooshrank.com/api/v1/connect/accounts", {
method: "POST",
headers: {
Authorization: "Bearer <your key>",
"Content-Type": "application/json",
},
body: JSON.stringify({ provider: "google_business", label: "Nona's Bakery" }),
});import requests
requests.post(
"https://swooshrank.com/api/v1/connect/accounts",
headers={"Authorization": "Bearer <your key>"},
json={"provider": "google_business", "label": "Nona's Bakery"},
)SDKs — Soon
One key for your whole organization. No per-agent keys, no per-platform keys, nothing to rotate when you add a client.
Ask the API for a connect link and send it to your client. They sign in with the platform they already use and pick which accounts to share.
Publish a post, read the reviews, reply to one, pull the numbers. The same 30 tools on every platform, so an agent learns them once.
Each one names what it plugs into, which of the 30 tools it calls, and what the connected accounts cost.
Three exist today. The rest are named here so the shape of the product is visible, not so they can be counted on.
One HTTP transport and one bearer header. Every tool, in any MCP client.
LiveThe same 30 operations as plain HTTP, for anything that is not an MCP client.
LiveGenerated from the same schemas the tools validate against, so a client can be generated from it.
LiveA callback when a client finishes connecting, or when a new review arrives.
SoonA typed client per language, published from the same document.
SoonNumbers, SMS and calls as accounts an agent can work the same way.
SoonWrite what the agent did back into the system of record.
SoonAn agent writing with a hosted model, billed per use. Not built, and not priced.
SoonNamed here so the shape of the product is visible, not so it can be counted on. Nothing below has a price, because nothing below is built.
Meta Ads, Google Ads, TikTok Ads
SoonWhatsApp Business, SMS, Voice calls
SoonYou already hold the relationships. Carry every client's accounts under one key, and send one link per client instead of chasing a password.
Your client authorizes on the platform they already use and keeps control of it. Revoking the grant on the platform revokes it here, without asking you.
Ship the agent, not five OAuth integrations. Your code holds one key and never a customer's credential, so the accounts stay with whoever owns them.
The tool surface stops growing when the platform list does. 30 tools, one shape, one error vocabulary — and the account id is the only thing you pass around.
You pay for what you connect. Nothing else.
$1 a month per connected account
billed yearly ($12 a year)
First two free. No card up front, and nothing to cancel while you stay inside the free tier.
One account is one platform, authorized by the one person who owns it. Disconnect it and it stops being billed from the next cycle.
A SwooshRank product.
SwooshConnect is the API. SwooshRank is the company that holds the platform access behind it, which is why the consent screen your client sees names SwooshRank and not the product they were sent to.
Same company, same grant, one key. Your client's accounts stay their own, and revoking the grant on the platform revokes it here.
More platforms are coming.
Get a key, send one link, and watch an agent read the account back. Nothing to install, and nothing to cancel while you stay inside the free tier.
claude mcp add --transport http \
swooshconnect \
https://swooshrank.com/api/mcp \
--header "Authorization: Bearer <your key>"One endpoint: https://swooshrank.com/api/mcp