> ## Documentation Index
> Fetch the complete documentation index at: https://f82cc46-productmetrics.manicule.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://f82cc46-productmetrics.manicule.dev/docs/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://f82cc46-productmetrics.manicule.dev/docs/api/mcp.
> Every agent surface: https://f82cc46-productmetrics.manicule.dev/docs/.well-known/llms-manifest.json

# Product Metrics in Cursor (/docs/integrations/cursor)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 1506 · updated: 2026-11-16 -->
Related: [Product Metrics in ChatGPT and Codex](/docs/integrations/chatgpt.md), [Product Metrics in Claude and Claude Code](/docs/integrations/claude-code.md), [Product Metrics in Claude Desktop and Cowork](/docs/integrations/claude-desktop.md), [Get started with the Product Metrics MCP server](/docs/mcp/overview.md)

> Add the Product Metrics MCP server to Cursor in one click, sign in through your browser, and set up tracking or analyse Google Ads from a chat.

Give Cursor's agent your stores, products and Google Ads account, and let it run Product Metrics setup for you.

| Setting         | Value                                                                            |
| --------------- | -------------------------------------------------------------------------------- |
| **Server name** | `product-metrics`                                                                |
| **Server URL**  | `https://www.productmetrics.io/mcp`                                              |
| **Sign-in**     | Browser sign-in to Product Metrics (OAuth), then **Connect Cursor**. No API key. |

`https://www.productmetrics.io/mcp` is a client setting, not a page to open in a browser.

## Quick setup



[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=product-metrics\&config=eyJ1cmwiOiJodHRwczovL3d3dy5wcm9kdWN0bWV0cmljcy5pby9tY3AifQ==) opens the install dialog in Cursor.

1. Click **Add to Cursor** to open the install dialog in Cursor.
2. Confirm the **product-metrics** server.
3. Click the sign-in prompt next to **product-metrics** in Cursor's MCP settings. Your browser opens the Product Metrics consent page: click **Connect Cursor**.
4. Check that the Product Metrics tools are listed under **product-metrics**.



**Prefer to add the configuration by hand?** Add this to `~/.cursor/mcp.json` (every project) or `.cursor/mcp.json` (one project):

```json
{
  "mcpServers": {
    "product-metrics": {
      "url": "https://www.productmetrics.io/mcp"
    }
  }
}
```

Save the file, then sign in from Cursor's MCP settings. `productmetrics mcp-config --client cursor` prints this snippet.

## Try it

```text
Which Product Metrics stores can I open, and what is left to set up?
```

```text
Which campaigns have the lowest POAS over the last 30 days?
```

## Optional: skills and the CLI

Skills give the agent the exact steps for tasks such as setting up tracking. The `productmetrics` CLI gives it the same API as terminal commands with JSON output.

```bash
npx skills add https://www.productmetrics.io/docs --skill '*' --agent cursor -y
npm install -g @productmetrics/cli
```

Run `productmetrics login` in your own terminal, and set `PM_AGENT=1` so `productmetrics` never prompts when the agent runs it. Details: [For agents](/docs/mcp/for-agents) and [CLI for agents](/docs/cli/for-agents).

## What you can ask

```text
> Where is my Product Metrics setup, and what is the next step?
→ execute (GET /setup/status), or productmetrics setup get-status --json

> Connect my WooCommerce store to Product Metrics.
→ execute (POST /companies/:companyId/stores), or productmetrics stores connect
  --company-id <company_id> --provider woocommerce --store-url
  https://shop.example --json
  then tells you to paste the setup token into the Product Metrics
    plugin in your store admin

> Create the Product Metrics conversion actions in Google Ads.
→ execute (POST /properties/:propertyId/google-ads/conversion-actions)

> Which campaigns have the lowest POAS over the last 30 days?
→ list_properties, then get_poas_report (level: campaign, sort_by: poas,
  order: asc)

> Why did my Google Ads conversion value drop since Monday?
→ list_properties, then explain_google_ads_change
```

Analysis tools only read: they never change Google Ads or your store. Operations that delete something run only after you confirm, and steps that need you in a browser come back as a link. Every tool: [MCP tools](/docs/mcp/tools).

For a project that should only see one store, use `https://www.productmetrics.io/mcp?selectedAccountPropertyId=<propertyId>` as the URL in `.cursor/mcp.json`.

## Troubleshooting

| Problem                                                                           | Fix                                                                                                             |
| --------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| **product-metrics** doesn't appear in Cursor's MCP settings                       | Check that `mcp.json` is valid JSON, then restart Cursor or run **Developer: Reload Window**.                   |
| Sign-in is required or has expired                                                | Sign in again from Cursor's MCP settings. The connection lasts 30 days from approval.                           |
| Another Product Metrics server already exists                                     | Keep one entry with the URL above, so only one server is active.                                                |
| "This connection only has MCP access, so it cannot call the Product Metrics API." | Remove the server, add it again and allow everything the consent page shows.                                    |
| "The MCP server is not enabled for this account yet."                             | Ask Product Metrics support to turn it on for your account.                                                     |
| "This property needs a Product Metrics Pro subscription for the MCP server."      | Upgrade that store to Pro, or ask about another store.                                                          |
| `productmetrics` exits `4`                                                        | A person must finish a step in a browser. Open `next_action.url`, then ask the agent to check the status again. |
| The agent doesn't use a skill                                                     | Run `npx skills list`, check it is installed for `cursor`, then reload the window.                              |

## More

* [Get started](/docs/mcp/overview) with Product Metrics MCP in other clients.
* [For humans](/docs/mcp/connect): the consent page and browser sign-in in detail.
* [MCP tools](/docs/mcp/tools): what each tool does, with its arguments.
