MCP server

Run Benson from your AI agent.

Connect Claude, ChatGPT, Cursor or any MCP client. Your agent can set up your store, answer questions about it and make changes once you say yes.

Server URL

https://api.trybenson.com/mcp

Sign in with your Benson account. You choose read-only, or read and changes.

Add to VS CodeAdd to CursorAdd to Claude

Works with

What your agent can do

Ask in your own words.

  • Set up

    From domain to live

    Add your store, get the snippet, check it's live and apply the recommended setup.

  • Read

    Ask about your numbers

    Extensions and what they cost, orders, insights, offers and AI agent traffic.

  • Change

    Make the everyday changes

    Blocker mode and rules, checkout policy, offers and invitations. Each one asks first.

Try asking

  • Set up Benson on mystore.com and tell me when it's live.
  • Which extensions cost me the most last month?
  • Block Honey's pop-ups on product pages, with a holdout.
  • Is anything taking affiliate credit for my orders?
  • What changed this week, and what should I do about it?
  • Invite [email protected] as an admin.
Tools

35 tools, grouped by job.

Reads change nothing. Anything marked Asks first shows a preview and waits for your yes.

Account and stores

  • get_account

    Who you are, the organization this connection acts for, its plan, its stores and what this connection may do.

    Reads
  • create_site

    Add a store to Benson and get its install snippet.

    Asks first
  • update_site

    Rename a store, change its domain or timezone, or pause and resume tracking.

    Asks first

Install and set up

  • get_install

    Install status, the snippet and the steps for the store's platform.

    Reads
  • check_install

    Check the storefront now and report whether Benson is live on it.

    Reads
  • send_install_instructions

    Email the install steps to a developer.

    Asks first
  • start_test_session

    Get a link that shows Benson catching a simulated coupon pop-up on your own store, live in the dashboard.

    No changes
  • get_setup

    The setup checklist and the setup Benson recommends for the store.

    Reads
  • apply_setup

    Apply the recommended setup, or the parts of it you choose.

    Asks first

Measure

  • get_analytics

    Sessions, extension share, conversion, order value and revenue for a date range, as a summary, a trend or a breakdown.

    Reads
  • list_extensions

    Which coupon and cashback extensions your shoppers run, how often, and what they cost.

    Reads
  • get_store_audit

    Your discount numbers from recent orders: how much went on codes, and which codes.

    Reads
  • get_orders

    Order totals, attribution coverage and the discount codes used, extension sessions marked.

    Reads
  • get_value

    What Benson has protected for the store, measured against the holdout.

    Reads
  • get_ai_agents

    AI shopping agents and automation on the store, and the policy they get.

    Reads
  • get_attribution

    Affiliate and UTM overwrites by extensions, and the commission they redirect.

    Reads
  • get_live

    Who is on the store right now, and which extensions are active.

    Reads

Insights

  • list_insights

    Open insights for the store, each with the action Benson recommends.

    Reads
  • act_on_insight

    Apply an insight's recommended action, or dismiss, snooze or reopen it.

    Asks first

Block

  • get_protection

    The blocker's mode, rules and holdout, and the checkout code policy.

    Reads
  • simulate_blocker

    See which pop-ups the current rules would hide for a given visitor, changing nothing.

    Reads
  • set_blocker_mode

    Switch the blocker between observe and block, and start or stop its holdout.

    Asks firstStop plan
  • save_block_rule

    Create a blocking rule, from scratch or a preset, or change an existing one.

    Asks first
  • delete_block_rule

    Delete a blocking rule.

    Asks first
  • update_checkout_policy

    Change the checkout code policy: its mode, the message shoppers see, and allowed codes.

    Asks first

Offers and tests

  • list_campaigns

    Your on-site offer campaigns, with status, codes and performance.

    Reads
  • save_campaign

    Create a draft offer campaign or edit one. Drafts never show to shoppers.

    Asks first
  • set_campaign_status

    Publish, pause or resume an offer campaign on the storefront.

    Asks firstOwn plan
  • list_discount_codes

    The store's discount codes Benson knows about, and which are public or private.

    Reads
  • list_experiments

    A/B experiments and their results.

    Reads

Team

  • list_team

    Members, their roles, and pending invitations.

    Reads
  • invite_teammate

    Invite someone by email to join as an admin or a member.

    Asks first
  • cancel_invitation

    Cancel a pending invitation.

    Asks first

Playbooks and guides

  • list_playbooks

    Playbooks for the store, with progress and the next step.

    Reads
  • search_guides

    Search Benson's guides and docs for how to do something.

    Reads

Prompts

Ready-made starts. In Claude Code they're slash commands, like /mcp__benson__weekly_review.

  • set_up_store

    Set up Benson on my store. Add the store, install Benson, check it's live and apply the recommended setup.

  • weekly_review

    Weekly review. What changed this week: extension traffic, its cost, new insights and what to do next.

  • stop_coupon_popups

    Stop coupon pop-ups. Measure first, then block the extensions that cost the most, with a holdout to prove it.

Arguments, errors and limits in the reference
Every change asks first

Nothing changes until you say yes.

  1. PreviewYour agent shows what would change, where, and for whom.
  2. You say yesOr no. Without a yes, nothing happens.
  3. DoneThe change is made once and logged as made through your agent.
Example conversationBenson connected

  1. You: Switch the blocker on mystore.com to block mode.

  2. set_blocker_mode→ needs confirmation
  3. Agent: Nothing has changed yet. On mystore.com the blocker would go from Observe to Block. Pop-ups your rules match would be hidden on your storefront, except for shoppers in the holdout. Shall I go ahead?

  4. You: Yes, go ahead.

  5. set_blocker_mode→ confirmed
  6. Agent: Done. The blocker on mystore.com is in Block mode. Your audit log shows the change, made via Claude.

Never through an agent

These stay in the dashboard, behind its own confirmations.

  • Billing: choosing a plan, checkout, cancelling
  • Deleting a store, purging its data, or deleting the organization
  • Rotating site keys, policy keys or edge secrets
  • Removing members, changing roles or transferring ownership
  • Connecting integrations that need a secret (email platforms, Slack)
  • Exporting all of the organization's data
Permissions and safety

It can't do more than you can.

  • Standard sign-in

    Add the URL and sign in to Benson in your browser. There are no keys to paste.

  • One organization per connection

    You pick it when you connect. Agencies connect once for each client.

  • Read-only if you like

    Turn off “Make changes, after you confirm each one” when you connect, and your agent can only read.

  • Your role still applies

    Members can only read. Every call goes through the same checks as the dashboard.

  • See it, stop it

    Settings → AI agents lists each connection and its recent calls. Disconnect takes effect on its next call.

  • Shopper text stays data

    Text shoppers can write, like UTM tags and codes, is marked untrusted, and your agent is told to treat it as data.

Set up

Set up in your client.

Your AI client

Using another client? The reference covers discovery, scopes and errors.

MCP server reference
Agent keys

No browser? Use an agent key.

For CI jobs, scripts and agent backends that can't sign in. Create one in Settings → AI agents.

  • Shown once, then stored only as a hash
  • Works in one organization
  • Read, or read and changes
  • Revoke it any time

.mcp.json

{
  "mcpServers": {
    "benson": {
      "type": "http",
      "url": "https://api.trybenson.com/mcp",
      "headers": {
        "Authorization": "Bearer ${BENSON_AGENT_KEY}"
      }
    }
  }
}

Questions

Every plan, Free included. Your agent can do what your plan includes. If a change needs more, like blocking on Stop or publishing offers on Own, the preview says which plan before anything happens.

Connect your agent. Every change waits for your yes.

Read the referenceAdd to Claude