Skip to content
Get started

Product Metrics in Cursor

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.

SettingValue
Server nameproduct-metrics
Server URLhttps://www.productmetrics.io/mcp
Sign-inBrowser 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

  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.

Try it

Which Product Metrics stores can I open, and what is left to set up?
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.

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 and CLI for agents.

What you can ask

> 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.

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

ProblemFix
product-metrics doesn’t appear in Cursor’s MCP settingsCheck that mcp.json is valid JSON, then restart Cursor or run Developer: Reload Window.
Sign-in is required or has expiredSign in again from Cursor’s MCP settings. The connection lasts 30 days from approval.
Another Product Metrics server already existsKeep 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 4A 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 skillRun npx skills list, check it is installed for cursor, then reload the window.

More

  • Get started with Product Metrics MCP in other clients.
  • For humans: the consent page and browser sign-in in detail.
  • MCP tools: what each tool does, with its arguments.