MCP for Claude and Cursor

Talk to your store data without exporting CSVs into the void.

StoreMetrics ships a read-only MCP server. Your AI can list sites, pull KPIs, pages, sources, geo, audience, funnel, and live activity.

Create a token

1. Open a site → Settings → Integrations → MCP
2. Create a token (shown once — copy it)
3. Endpoint: https://YOUR_STOREMETRICS_HOST/api/mcp

One account-level token works across your sites.

Connect Cursor

Add to MCP config (Cursor settings / mcp.json):

{
  "mcpServers": {
    "velora": {
      "url": "https://YOUR_STOREMETRICS_HOST/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VELORA_MCP_TOKEN"
      }
    }
  }
}

Connect Claude Code

claude mcp add --transport http velora https://YOUR_STOREMETRICS_HOST/api/mcp \
  --header "Authorization: Bearer YOUR_VELORA_MCP_TOKEN"

Connect Claude Desktop

{
  "mcpServers": {
    "velora": {
      "type": "streamable-http",
      "url": "https://YOUR_STOREMETRICS_HOST/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VELORA_MCP_TOKEN"
      }
    }
  }
}

Tools

Tool	Job
list_sites	Get site handles — call first
get_site_context	Timezone, currency, caveats
get_overview	KPIs + live visitors
get_pages	Top pages / intent-ish engagement
get_traffic_sources	Source breakdown
get_geo	Country / region / city
get_audience	Device / browser / OS
get_funnel	Funnel stages + drop-off
get_live	Active now + recent events

Ranges

Presets like today, yesterday, last_7d, last_30d, … or YYYY-MM-DD/YYYY-MM-DD in the site timezone. Default is typically last_30d when omitted.

Prompt pack

Using StoreMetrics MCP:
1. list_sites
2. get_site_context for my main store
3. get_overview today and last_7d
4. get_funnel last_7d
5. get_traffic_sources last_7d
6. Tell me what to do in the next 24 hours — 5 bullets max

Using StoreMetrics MCP get_live + get_overview for today:
Is the store alive right now? Any scary drop vs yesterday? One sentence each.

Safety

• Tokens are secrets. Revoke from Settings if they leak.
• Read-only — MCP cannot change Settings or delete sites.
• Never paste tokens into public chats or commits.