Pricemind MCP

Connect your assistant

Ask about your prices, competitors and matches from Claude, Codex, Cursor or any MCP client. Pick your assistant, run the command, sign in.

Server URLhttps://mcp.pricemind.io/mcp

Install

Adds the Pricemind connection to the coding agents it finds, such as Claude Code, Codex and Cursor.

  1. Add the connection

    Add -a <agent> to target one client, or -g to install globally.

    npx add-mcp https://mcp.pricemind.io/mcp --name pricemind
  2. Open your agent and sign in

    On first use it opens Sign in with Pricemind in your browser.

  3. Run the setup

    Pick setup from the prompt menu, or ask:

    Set up Pricemind: check the connection, pick my channel and suggest three first questions.

Try it

Ask in plain words. Your assistant picks the tools.

  • Who undercut me this week?
  • Prepare the Q2 pricing review
  • Check the price of <product>

Ready-made workflows

Claude Code: /pricemind:<name>. Codex: type $ and pick one. Other clients: pick it from the prompt menu.

  • setupStart here
    Set up Pricemind

    Check the connection, pick a channel, explain what Pricemind can do, and suggest three first questions.

  • weekly-review
    Weekly pricing review

    Last week's competitor price moves, position gained or lost, new out-of-stocks and the top 10 products to act on.

  • management-report
    Management pricing report

    Period-over-period review: price index, position by brand and category, and competitor activity, in a fixed structure.

  • promo-watch
    Promotion watch

    Who started cutting prices, how deep, since when, and in which categories.

  • price-check
    Price check for one product

    One product: your price, every competitor's price and stock, price history, and match-quality warnings.

  • own-brand-vs-market
    Own brand vs market

    Own-brand products against the cheapest comparable branded product, on channels with product groups.

How it behaves

Your assistant asks once per job, never per step.

Reading

Never asks.

Search, prices, matches, previews, explanations
Adding or reversible changes

Done when you ask, then reported with how to undo.

Match an offer, attach, add a comparable, start a crawl
Removing things or moving prices

One approval for the whole plan.

Unmatch, detach, remove a comparable, create or update a pricing strategy

The only other stop is decision_required: a material warning, a changed version, a wider scope or a missing permission. Nothing was changed, and the assistant asks you once.

Charts

Pricemind price history chart: your price against five competitors over 33 daysPricemind price history chart: your price against five competitors over 33 days
Pricemind draws the chart, not your assistant.

Reference

Connect with an API keyFor scripts, unattended agents and clients without sign-in

1. Choose capabilities

A key can do only what you select when you create it, and capabilities are fixed when the key is issued. Select every workflow the agent needs now. Pricemind adds MCP connection access and all prerequisite capabilities automatically.

WorkflowSelectAdd only when neededToolset
Products and pricesView channel productsView matched competitor offerssearch
Product discoveryView product discoveryManage comparable productsproduct-discovery
Product matchingView matchingConfigure matching, Run matching, Approve match changesmatching-analysis
Pricing strategiesView pricing strategiesManage pricing strategiespricing-strategies
Tracked crawlsView crawlsRun crawlscrawl

2. Create the key

  1. An account administrator opens a channel in the Pricemind app → Integrations → API Keys → Create MCP key. The key belongs to the account, not the channel.
  2. Give it a unique name per client and environment, such as codex-prod-v1.
  3. Copy the one-time secret into your secret manager and inject it as PRICEMIND_MCP_API_KEY.

3. Configure the client

Send the key in exactly one Authorization: Bearer … header. Do not use X-API-Key, and never put a key in a URL.

Codex
# PRICEMIND_MCP_API_KEY is injected by your secret manager

codex mcp add pricemind \
  --url https://mcp.pricemind.io/mcp \
  --bearer-token-env-var PRICEMIND_MCP_API_KEY

codex mcp get pricemind --json

Claude web and desktop: use sign-in, not a static Bearer key. Do not paste a key into a URL or claude_desktop_config.json.

Change access or rotate a key

Keys are not edited in place. Replace them without downtime:

  1. Create a replacement MCP key with a new unique name and every capability it needs.
  2. Switch the client to the new secret and reconnect.
  3. Check that the expected tools appear and a read works.
  4. Only then revoke the old key. Revocation is immediate.

If a key may be compromised, revoke it at once instead.

Existing IP-restricted API keys cannot connect through MCP. MCP keys created in the app are ready to use. Keep IP allowlists on direct Core API credentials.

ToolsetsShow the assistant fewer tools for a focused job

A toolset hides tools to keep the assistant focused. It never grants access: a session still sees only what its sign-in or key allows. Add ?toolset=<id> to the server URL. Change it any time; no replacement key is needed.

allGeneral agents that move between search, discovery, matching, pricing, and crawls.
product-discoveryResearch and assortment-comparison workflows.
matching-analysisEvidence review without mutation tools in the model context.
matching-operatorSessions that must operate matching, not only analyze it.
pricing-strategiesFocused pricing policy design and maintenance.
crawlSmall-context crawl operations and diagnostics.
searchPrice intelligence and reporting assistants.

Only all (the default) publishes the workflow prompts.

Changes, batches and retriesWhat the server does when your assistant changes data
  • One call per change. *_execute_* tools take the exact intent, a stable idempotency_key and optional acknowledgements for warnings you already accepted.
  • Batches. Batch tools take 1–25 items and return one summary with how to undo.
  • Previews are for when you want to see a change without making it.
  • Retries. Reuse an idempotency key only for the same command; a retried batch does not repeat items that already ran. Changed intent needs a new key.
  • Audit. Changes are recorded as authorized execution, never as human-confirmed. Approval prompts from your MCP client are separate from these rules.
executedChanged by this call.
already appliedAlready in the requested state, for example on a retry; nothing changed again.
needs a decisiondecision_required: not changed. Ask once about these items only.
failedRejected; not changed.
unverifiedThe outcome is unknown, so the batch stopped. Read state, then retry with the same idempotency_key.
not attemptedSkipped after the batch stopped. Retry with the same idempotency_key.
Account boundaryWhose data a connection can reach

A sign-in or key belongs to one Pricemind account and lists that account's channels. Channel tools use channel_id as the boundary and accept no account selector. Pricemind staff use a separate, approved, time-limited profile for cross-account work; customer-created keys cannot select or gain that access.

Check the connection by handA raw request for network or key problems

Your client does this by itself. Use it only to isolate a network or key problem, with the key already in your environment, not in shell history.

Initialize request
# PRICEMIND_MCP_API_KEY is already injected by your secret manager

test -n "$PRICEMIND_MCP_API_KEY" || {
  echo "PRICEMIND_MCP_API_KEY is not set" >&2
  exit 1
}

curl --fail-with-body --silent --show-error --request POST https://mcp.pricemind.io/mcp \
  --header "Authorization: Bearer $PRICEMIND_MCP_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json, text/event-stream" \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": {"name": "connection-check", "version": "1.0"}
    }
  }'
TroubleshootingErrors, missing tools and rejected changes
400Invalid server URLUse at most one toolset value and no other query parameters.
401Not signed inSign in again, or reconnect if the app was disconnected. With a key: check the client inherited PRICEMIND_MCP_API_KEY, sends one Authorization header and the key is not revoked.
403Key cannot use MCPCreate an MCP key in the app. IP-restricted keys and keys without MCP connection access are rejected.
413Request too largeKeep requests under 2 MiB.
5xxService unavailableRetry reads with backoff. For a change, read the current state first, then retry the same intent with the same idempotency key.

Connected, but something fails

  • A tool is missing. Check the toolset in the URL first. If the key lacks the capability, replace the key.
  • A tool returns invalid, forbidden or stale. decision_required changed nothing. Read the state again, then send the new intent with a new idempotency key.
  • Rate limited. Honour Retry-After or back off. Never change an idempotency key to get around a limit.
All 61 tools, scopes and promptsSearch the catalogue by name or by what a tool does.