MCP server (Streamable HTTP JSON-RPC) — Pricefy API Reference
POST /mcp — **Model Context Protocol** endpoint. Speaks JSON-RPC 2.0 over HTTP (Streamable HTTP transport, MCP spec 2025-11-25).
**Two authentication options**:
- `X-Api-Key: ` — same header as the REST API. Use this with Claude Desktop, Cursor, Codex, and any client that supports custom headers.
- `Authorization: Bearer ` — OAuth, used by ChatGPT custom connectors. Set it up from the connector dialog: see the **MCP support** section on the main page for the step-by-step guide.
Permissions are enforced on every tool call — an authorization granted as read-only can never invoke destructive tools, regardless of how it was issued.
**Setup snippets**: see the introduction at the top of this page.
**Available tools (25)**
Read-only (18):
`get_account`, `get_store`, `list_products`, `get_product`,
`list_competitors`, `get_competitor`, `list_monitored_urls`, `get_monitored_url_detail`,
`list_repricing_rules`, `get_repricing_preview`,
`list_reports`, `get_report`,
`list_alerts`, `list_alert_rules`, `get_alert_rule`, `get_alerts_for_rule`,
`list_map_infringements`, `list_map_infringement_rules`.
Write (5):
`upsert_product`, `bulk_upsert_products`, `add_competitor`,
`update_competitor_status`, `batch_upsert_monitored_urls`.
Destructive (2, require client confirmation):
`delete_product`, `batch_delete_monitored_urls`.
**Discovery via JSON-RPC**:
- `initialize` — handshake (returns the `MCP-Session-Id` header)
- `tools/list` — full tool catalog with input schemas
- `tools/call` — invoke a tool by name with arguments Part of the Pricefy REST API.
Authentication: send the X-Api-Key header on every request. Base URL: https://api.pricefy.io.
OpenAPI specification ·
llms.txt ·
llms-full.txt
Merchant account, subscription and plan limits.
Store information and last import.
Merchant product catalog. Cursor-based pagination.
Competitor domains with price analysis.
URLs being monitored on each competitor, with stock and price diff.
Minimum Advertised Price rules and the resellers that breach them.
Dynamic pricing rules and repricing previews.
Scheduled reports configuration.
Alert rules and triggered alerts (price/stock variations).
**Model Context Protocol** — same Pricefy API, exposed as MCP tools so Claude Desktop, Cursor, ChatGPT, Codex and the Claude CLI can call it natively. Streamable HTTP transport, JSON-RPC 2.0, dual auth (`X-Api-Key` **or** OAuth 2.1 Bearer), same per-merchant permissions as REST. 25 tools (18 read-only + 5 write + 2 destructive). See `POST /mcp` for the full catalog and the landing page for connection guides.
<img src="https://voyager.postman.com/logo/postman-logo-icon-orange.svg" alt="Postman" width="48" align="left" style="margin-right:12px"/>
The **complete Pricefy API collection** lives in the [public Pricefy Postman workspace](https://www.postman.com/pricefy/workspace/pricefy-api) — every endpoint, request body, query parameter and response example, pre-wired and ready to send. Use it to explore the API in Postman desktop / web, fork it into your own workspace, or run it as part of an automated test suite via Newman.
[](https://www.postman.com/pricefy/workspace/pricefy-api)
Alternatives:
- [Browse the workspace](https://www.postman.com/pricefy/workspace/pricefy-api) directly on postman.com
- [Download the collection JSON](/postman/collection.json) and import manually into Postman or Newman
