# CostRadar MCP server

Source: https://costradar.ai/docs/mcp/

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.

## 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_shops`, `costradar_get_order_stats`, `costradar_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_cost`, `costradar_update_product_cost`, `costradar_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_overview`, `costradar_get_forecast`

### Premium analysis (8)

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

`costradar_ask_costradar`, `costradar_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_ask`, `costradar_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.
