Rockerbox MCP

Rockerbox for Claude

Your marketing data, one conversation away

The Rockerbox connector links Claude to your Rockerbox account. Ask about attribution, platform spend, conversions, or cross-channel comparison in plain English—Claude handles the rest.

claude.ai Claude Desktop Claude Team / Enterprise

The organization connector is all you need—it works in claude.ai and Claude Desktop. The Desktop extension is only a fallback if your organization can’t add the connector.

Add Rockerbox to your Claude organization

Add Rockerbox once as an organization-wide custom connector. Members then just click Connect—no files to distribute. Only Claude organization owners can add custom connectors; members who try see “Ask an organization owner to add this for your team.”

1

Open Organization settings → Connectors

In claude.ai, go to Organization settings → Connectors → Add → Custom → Web.

2

Add the Rockerbox connector

  • Name: Rockerbox
  • MCP server URL: https://mcp-customer.rockerbox.com/mcp/ (keep the trailing slash)
  • Authentication: Sign in now
  • OAuth client: Use your own OAuth client
    • Client ID: rockerbox-mcp
    • Client secret: leave blank (this is a public PKCE client)
  • Transport: Streamable HTTP
https://mcp-customer.rockerbox.com/mcp/
Common pitfall: the dialog defaults to “Use Claude’s published identity.” The Rockerbox server does not support it yet, and leaving the default fails with “Automatic client registration isn’t supported by Rockerbox.” Switch to Use your own OAuth client and enter the Client ID above.
3

Security and access

  • Adding the connector grants no data access. Each user signs in with their own Rockerbox login (OAuth 2.1 + PKCE) and sees only the advertisers their Rockerbox permissions allow.
  • No shared credentials or API keys are stored in Claude.
  • The connector appears for all members of the organization; Claude does not document per-group restriction.
  • It also works in Claude Desktop once added. The .mcpb extension (see the Desktop extension fallback on the For advertisers tab) stays available as a fallback.
✓

Checklist for the org owner

  • Open Organization settings → Connectors → Add → Custom → Web
  • Name Rockerbox; URL https://mcp-customer.rockerbox.com/mcp/ with the trailing slash
  • Authentication set to Sign in now
  • Use your own OAuth client selected, Client ID rockerbox-mcp, secret blank
  • Connector saved, then confirm it shows as Rockerbox (Custom) under Settings → Connectors
  • Members told to follow Start using Rockerbox in Claude (the For advertisers tab)

Questions? Email [email protected].

Connect Rockerbox in Claude

These steps come after your IT team or Claude organization owner has added the Rockerbox connector.

0

Before you start: your IT team adds the connector

Only a Claude organization owner can add Rockerbox, once, for everyone. If you don’t see Rockerbox under Settings → Connectors, it hasn’t been added yet—send your IT team or org owner the setup instructions for organizations, then come back here.

Before you connect: log into app.rockerbox.com in the same browser you use for Claude. This is required for now—a sign-in request from a logged-out browser is dropped.
1

Find Rockerbox in Settings → Connectors

In Claude, open Settings → Connectors and search for Rockerbox (labeled Custom).

Claude Connectors page with the search box containing "rocker" and the Rockerbox custom connector row showing a Connect button
2

Click Connect

Click Connect next to Rockerbox, as highlighted above.

3

Sign in to Rockerbox

A Rockerbox page opens in your browser. Approve the sign-in to let Claude use your Rockerbox access.

4

Check that it shows as connected

Back in Claude, Rockerbox now shows as connected.

5

Turn Rockerbox on in your chat

In a chat, open the tools / connectors menu and switch Rockerbox on.

6

Ask your first question

Start a new chat and ask anything about your data. To confirm everything works, see Check that it works below.

Check that it works

Whichever way you set up, paste this prompt into a new chat to confirm everything is connected.

Quick smoke test

Open a new conversation in Claude and ask:

What Rockerbox account am I on?

First time? A browser tab will open for sign-in. After you authenticate, Claude will show your advertiser name and email.

Advertiser: Acme Corp

If you see your account info, you’re ready to go. Try any of the prompts below.

What you can ask

Ask Claude about your marketing data the same way you’d ask a colleague. Seven things it can do—pick one to see more example questions.

Explore your performance
MTA

Attributed Performance

Rockerbox multi-touch attribution data—conversions, revenue, ROAS, and CPA by channel, campaign, or any breakdown level.
"How did Paid Social perform last month?"
Try asking
"How did Paid Social perform last month?"
"Show me ROAS by channel for the last 30 days"
"Break down Meta by campaign for last week"
"Compare first-touch and last-touch for Paid Search this quarter"
"How much revenue came from new vs. repeat customers last month?"
"Show me weekly ROAS by channel for the last 90 days"
Returns conversions, spend, revenue, ROAS, and CPA with period-over-period comparisons. You can break down by channel, tier, campaign, or any level in your Rockerbox taxonomy, compare attribution models (Modeled Multi-Touch, even, first-touch, last-touch), split new vs. repeat customers, and trend results by day, week, or month. Pick a conversion event by name or ID. If a data pipeline issue affects the period you asked about, the answer calls it out.
These are Rockerbox-attributed numbers and may differ from what Meta or Google Ads Manager reports. Use the Comparison tool below to see both side by side.
$

Platform Spend

Spend, impressions, clicks, and delivery metrics as reported directly by Meta and Google Ads.
"What did we spend on Meta last month by campaign?"
Try asking
"What did we spend on Meta last month by campaign?"
"Show me Google Ads impressions and clicks for the last 14 days"
"Break down Meta spend by ad set for this month"
Returns platform-reported spend and delivery metrics with a clear label that these come from the ad platform, not Rockerbox attribution.
Cv

Platform Conversions

Conversions, revenue, ROAS, and CPA as reported by Meta and Google Ads—the numbers you see in their dashboards.
"Show me Meta purchase conversions and ROAS by campaign"
Try asking
"Show me Meta purchase conversions and ROAS by campaign"
"What does Google Ads report for conversions last week?"
"Which conversion events does Meta track for us, and how do they compare?"
"Show Meta view-through conversions by campaign for last week"
Returns platform-reported conversion metrics. You can list every conversion event the platform tracks for your account, pick a specific one (purchases, sign-ups, etc.), and choose the attribution window and interaction type (click or view-through).
vs

Attribution vs. Platform Comparison

See Rockerbox-attributed and platform-reported numbers side by side to understand where they agree and where they diverge.
"Compare our Rockerbox attribution to what Meta reports for last month"
Try asking
"Compare our Rockerbox attribution to what Meta reports for last month"
"How do Google Ads numbers compare to Rockerbox by campaign?"
Returns both sources side by side per campaign with the gap highlighted. Spend reconciles (it’s the same number); conversions and revenue are where the attribution models diverge.
Work with your data
CSV

Data Exports

Download full attribution, spend, or platform conversion data as a CSV file—no row limits.
"Export last month’s MTA data by campaign as a CSV"
Try asking
"Export last month’s MTA data by campaign as a CSV"
"Download daily Meta spend by ad set for Q3"
"Give me a spreadsheet of Google Ads conversions by campaign for the last 90 days"
Claude first shows an export plan—the date range, breakdown, columns, file name, and how long the download link stays valid. Once you confirm, it returns a download link with the row count and file size. Files hold raw totals; calculate ROAS, CPA, and other ratios in your spreadsheet.
Exports over 250 MB are refused. Shorten the date range, add filters, or use weekly or monthly rows instead of daily.

Data Status

Check whether your spend and conversion data arrived on time—the same view as your Data Status Report.
"Is my Rockerbox data healthy right now?"
Try asking
"Is my Rockerbox data healthy right now?"
"Why does Meta spend look low for last Tuesday?"
"Did any platform integrations fail this month?"
Returns each platform and data type with its status, the number of failed days, and first and last failure dates. When something needs your attention—like reconnecting a platform account—it tells you what to do.

Accounts & Events

See which accounts you can access, switch between them, and list each account’s conversion events.
"What account am I on?"
Try asking
"What account am I on?"
"Which accounts do I have access to?"
"Switch to our Canada account"
"What conversion events are available?"
If your login covers more than one advertiser, you can switch accounts mid-conversation; every question after that is answered for the new account until you switch back. Conversion event listing shows each event’s name and ID and whether it supports modeling, new vs. repeat customers, and revenue.

Troubleshooting

Tools are missing

  • Use Refresh tools on the connector, or start a new chat.

Sign-in loops or never completes

  • Make sure you are logged into app.rockerbox.com in the same browser, then try Connect again.

Need a different advertiser

  • Ask Claude to “Switch to <account>” using the advertiser name.

“Ask an organization owner to add this for your team”

Alternative: Desktop extension (only if your organization can’t add the connector)

Alternative: install the Desktop extension

Already connected Rockerbox through your organization? Stop here—you’re done. This section and First Login below are only for people whose organization can’t add the connector.

Two steps from download to running. You’ll need Claude Desktop installed on macOS or Windows.

The download link comes directly from the Rockerbox team—there is no public download. If you don’t have yours yet, ask your Rockerbox representative.
1

Install the extension

Save the .mcpb file you received, then double-click it. Claude Desktop opens and prompts you to install the extension—click Install.

You can also drag the file onto the Claude Desktop window, or go to Settings → Extensions → Install Extension and select the file manually.

No Terminal, no config files, no commands. The extension handles everything.
2

Start a conversation

Open a new conversation in Claude Desktop and ask anything about your Rockerbox data. The first time, a browser window will open for you to sign in (see First Login below).

Updating later? Same process—double-click the new .mcpb file. The extension replaces the previous version automatically.

First Login

Connector users sign in when they click Connect and can skip this. With the Desktop extension, the first time you ask Claude anything that touches Rockerbox data, a browser window will open for you to sign in.

1

Browser sign-in

Claude opens a secure browser tab. Sign in with your Rockerbox credentials. This uses OAuth (PKCE)—the MCP never sees your password.

2

Automatic refresh

Your token refreshes automatically in the background. You won’t need to sign in again unless the token is revoked or expires after extended inactivity.

If a sign-in link appears in the chat, click it—Claude will resume once you authenticate.

Troubleshooting the Desktop extension

Most issues resolve with one of these fixes. If you’re still stuck, email [email protected].

“Could not connect to MCP server”

The extension may not have loaded correctly. Try these in order:

  • Quit Claude Desktop completely with Cmd+Q (Mac) or close it from the taskbar (Windows)—just closing the window is not enough
  • Reopen Claude Desktop and start a new conversation
  • If it still fails, go to Settings → Extensions, uninstall the Rockerbox MCP extension, then double-click the .mcpb file to reinstall

Browser login window doesn’t appear

The login only triggers when Claude calls a Rockerbox tool. Make sure you’re asking a question that needs Rockerbox data (e.g. “What account am I on?”). If the browser still doesn’t open, check that your default browser isn’t blocking pop-ups.

Expired or stale token

If you see “unauthorized” errors or Claude asks you to sign in repeatedly, your session may have expired. Clear the cached tokens:

  • macOS: open Terminal and run rm -rf ~/.mcp-auth
  • Windows: delete the .mcp-auth folder in your home directory

Then quit and reopen Claude Desktop. Your next query opens a fresh browser login.

Browser opens multiple tabs during login

If multiple browser tabs open when you try to sign in, close all of them, then clear the cached tokens:

  • macOS: open Terminal and run rm -rf ~/.mcp-auth
  • Windows: delete the .mcp-auth folder in your home directory

Then quit and reopen Claude Desktop, and try again.

Tools missing after update

Claude Desktop loads extensions at launch. If you updated the extension but tools are still missing or showing the old version:

  • Quit Claude Desktop with Cmd+Q (Mac) or from the taskbar (Windows)
  • Reopen Claude Desktop
  • Start a new conversation

“403 Forbidden” errors

Your account may not have access to the requested data. Check which account you’re on by asking “What account am I on?” If the issue persists, contact your Rockerbox representative.