For AI agents and developers

CostRadar MCP server

Let your AI agent read your own profit data.

CostRadar runs a hosted MCP server. Claude Desktop, Cursor, and any MCP client can list your shops, read orders, costs, and true net profit, and ask Profit Agent a question. It only sees data your CostRadar user can already see.

See plans

What you need

  • A paid plan on at least one store you can access: Advanced or Premium. The Free plan has no API or MCP access.
  • An API key from Settings → Automations → API keys. Keys start with cr_live_.
  • Premium for the AI chat, portfolio, inventory, audiences, simulation, and Profit Agent tools.

Connect a client

The server uses Streamable HTTP. Send your key in the X-API-Key header.

Server URL

https://supabase.costradar.ai/functions/v1/costradar-mcp

Cursor

Add this to .cursor/mcp.json, save, and restart Cursor.

{
  "mcpServers": {
    "costradar": {
      "url": "https://supabase.costradar.ai/functions/v1/costradar-mcp",
      "headers": {
        "X-API-Key": "cr_live_YOUR_KEY_HERE"
      }
    }
  }
}

Claude Desktop

Add a remote MCP connector with the server URL above and the header X-API-Key set to your key.

OAuth is optional: clients can register dynamically and send Authorization: Bearer with the issued token instead of an API key.

What your agent can do

45 tools, all prefixed costradar_, plus 2 resources.

Read (19)

Advanced

Shops, costs, budgets, orders, order stats, product costs, metrics, targets, Pulse, store performance, P&L report summary, and anomalies.

costradar_list_shopscostradar_get_order_statscostradar_get_report_summary

Write (8)

Advanced

Create, update, and delete manual costs and budgets, update product costs (one or in bulk), and trigger a sync. Deleting a cost needs an explicit confirm flag.

costradar_create_costcostradar_update_product_costcostradar_trigger_sync

Performance and forecast (7)

Advanced, portfolio P&L on Premium

Performance overview, sales by channel, forecast, notifications, custom fields, and portfolio P&L.

costradar_get_performance_overviewcostradar_get_forecast

Premium analysis (8)

Premium

AI insights, AI chat, inventory batches, restock forecast, audience segments, campaign POAS, and simulations.

costradar_ask_costradarcostradar_run_simulation

Profit Agent (3)

Premium, store owner only

Ask Profit Agent, list the store memory it uses, and save a Profit Page briefing. These tools never run Approve and never call an ad bid API.

costradar_profit_agent_askcostradar_list_store_memories

Resources: costradar://product/overview for product docs and plan gates, and costradar://shop/{shop_id}/summary for a Pulse, metrics, and report snapshot.

Safety

  • Keys inherit your user permissions and your team shop access. An agent cannot see another merchant's data.
  • Write tools change your CostRadar records only. CostRadar does not change ad bids, prices, or listings in your stores.
  • Profit Agent tools are owner only, and Approve stays in the app and in Slack.
  • Never commit a key. Rotate it in Settings if it is exposed.

Questions about MCP

Which plans include the CostRadar MCP server?

Advanced and Premium. The Free plan has no API or MCP access. The AI chat, portfolio, inventory, audiences, simulation, and Profit Agent tools need Premium.

How does an MCP client authenticate?

With an API key from Settings → Automations → API keys, sent in the X-API-Key header. OAuth with dynamic client registration is also available.

Can an agent change my store or my ads through MCP?

No. Write tools edit costs, budgets, and product costs inside CostRadar, and can trigger a sync. CostRadar does not change ad bids, prices, or listings, and Profit Agent tools never run Approve.

What does a 401 error mean?

The key is missing or invalid. Check the X-API-Key header. An error about Advanced or Premium means the shop is on a plan without MCP access.