Getting started

Nerb is a hosted MCP gateway for your marketing stack. Connect your ad and analytics accounts once, then read and act on them from any LLM client (Claude, ChatGPT, Cursor, and more). Analytics and search data are read-only; for ad platforms, Nerb can also make the changes you direct, behind an explicit confirm step.

Three steps get you going: connect an account, point your client at the gateway, and start asking.

Connect an account

Create a Nerb account, then open Connected accounts and connect a platform. You authorize through the platform's own OAuth screen; Nerb stores an encrypted credential and never sees your password.

What you can connect today, and what Nerb can do with each:

• Google Ads: read and write (reporting plus changes you direct).
• Google Analytics 4: read-only.
• Google Search Console: read-only.
• Reddit Ads: read and write.

Connect your LLM client

The gateway endpoint is https://mcp.nerb.ai/v1 for every client. There are two ways to authenticate, depending on the client:

• OAuth (claude.ai web and desktop): add Nerb as a custom connector and approve a one-time authorization screen. Claude registers itself automatically, so there is no app to create and no client ID, secret, or token to paste.
• Bearer token (Claude Code, Cursor, and any client that accepts a custom header): copy your access token from Setup and send it as an Authorization: Bearer nerb_… header. Keep it secret; treat it like a password.

Claude (web or desktop)

Claude connects over OAuth and registers itself automatically, so there is nothing to set up in advance. In Claude, add a custom connector pointing at the gateway, then approve the authorization screen Nerb shows you:

Settings -> Connectors -> Add custom connector

Name:        Nerb
Server URL:  https://mcp.nerb.ai/v1

Claude registers itself, then opens Nerb's authorization page;
approve it, then enable the connector to start using it. No app
to create, no token or secret to copy or rotate.

Power users can still pre-register a confidential client: create one under OAuth apps on Connected accounts, set its redirect URI to https://claude.ai/api/mcp/auth_callback (Claude shows its callback in the connector dialog if it differs), then paste the client ID and secret into the connector instead.

Claude Code

claude mcp add nerb \
  --transport http https://mcp.nerb.ai/v1 \
  --header "Authorization: Bearer nerb_your_token_here"

Cursor

// .cursor/mcp.json, at the root of your project
{
  "mcpServers": {
    "nerb": {
      "url": "https://mcp.nerb.ai/v1",
      "headers": {
        "Authorization": "Bearer nerb_your_token_here"
      }
    }
  }
}

Setup has copy-paste snippets with your real token already filled in for the header-based clients (Claude Code, ChatGPT, Cursor, Codex). Nerb also works with VS Code Copilot, Windsurf, Gemini CLI, Continue.dev, Zed, and other MCP clients.

Ask your first question

Once connected, your client lists Nerb's tools and picks them for you. Just ask in plain language. For example:

• Which campaigns spent the most last week and what was the conversion rate?
• Find search queries we rank for organically that we're also paying for in Ads.
• Draft a 20% budget cut on the worst-performing campaign. Don't apply it yet.

Making changes safely

Read tools run immediately. Anything that would change a Google Ads or Reddit Ads account never applies directly: write actions follow a four-stage flow, so the model can plan a change and nothing happens to your account until you approve it.

1. A draft_* tool stages the change.
2. preview_changes shows exactly what will happen.
3. confirm_plan records your explicit approval. You can opt into auto-confirm per account on Connected accounts.
4. confirm_and_apply submits the approved plan to the platform.

Plans and pricing

Your first connected account is free and read-only. Paid is $9 per connected account per month (or yearly, about 25% off), which unlocks write tools and a higher request allowance. Manage your plan on the Billing page. Evaluating Nerb and need an extended free trial? Email hello@nerb.ai.

Tool reference

Nerb currently exposes 87 tools across the connected platforms. Your client only sees tools for platforms you have connected.

Getting help

Ask inside your client with nerb_contact_team, or email hello@nerb.ai. Useful links: Setup, Connected accounts, and Billing.