AI assistant (MCP)

What it is

Metricneed ships a Model Context Protocol (MCP) server. Point a compatible AI client — Claude on the web (claude.ai), Claude Code, Cursor, Claude Desktop or VS Code — at it and you can ask questions about your revenue in natural language instead of clicking through the dashboard.

There are two ways to connect, depending on your client:

• Sign in with your Metricneed account (OAuth) — for claude.ai on the web and Claude Desktop's built-in connector. You paste the server URL and approve access in your browser; no token to manage.
• Paste an access token — for Claude Code, Cursor, VS Code and Claude Desktop's config file.

• Ask things like “what's my MRR?”, “how is churn trending?” or “which product grew most last month?”.
• Read-only. The server only ever reads your metrics — it never creates charges, issues refunds or modifies anything.

Requirements

The MCP server is available on the Starter and Pro plans. If you're on Free, upgrade from billing settings to unlock it.

Either way, the server URL is the same:

https://metricneed.com/api/mcp

Connect Claude on the web (OAuth)

In claude.ai (or Claude Desktop's built-in connectors), add a custom connector and paste the server URL above — no token needed:

• Open Settings → Connectors and choose Add custom connector.
• Paste the server URL and continue.
• You'll be sent to Metricneed to sign in and approve access. Once you approve, Claude is connected — the connection is read-only and scoped to your account.

Revoke access at any time by removing the connector in Claude, or by signing out of the approving session. This path requires no token management.

Connect a token-based client

Claude Code, Cursor, VS Code and Claude Desktop's config file authenticate with a personal access token instead. Each token grants read-only access to a single account's revenue. Create one under Settings → MCP:

• Open Settings → MCP and choose Create token.
• Copy the token immediately — it's shown only once. Store it somewhere safe.
• Revoke a token at any time from the same page; a revoked token stops working right away.

Then add the server to your client, replacing <YOUR_TOKEN> with the token you created.

Claude Code — run:

claude mcp add --transport http metricneed https://metricneed.com/api/mcp --header "Authorization: Bearer <YOUR_TOKEN>"

Cursor / Claude Desktop / VS Code — add to your MCP config:

{
  "mcpServers": {
    "metricneed": {
      "url": "https://metricneed.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

Security

Access is a token you issue and can revoke at any time, and every request is read-only and scoped to your account. For how Metricneed handles your keys and data more broadly, see Security & privacy. To manage tokens, head to Settings → MCP.