The Avrix MCP connector lets AI assistants and agent tools — Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex and any other Model Context Protocol client — work with your Avrix account on your behalf. You add one URL, sign in with your Avrix account, choose the company the assistant may act on, and the assistant gets tools for exactly that company.
Who needs this#
- Content Sellers who want an assistant to browse the catalog they can sell, quote prices, place sandbox orders and check reports without writing integration code.
- Integration teams who want to explore the Seller API interactively before or while building.
- Anyone on Avrix who prefers asking questions ("which of my products are missing a price in Germany?") to clicking through the console.
TL;DR#
- Connector URL:
https://mcp.avrix.io/mcp— add it as a remote (Streamable HTTP) MCP server. There is nothing to install. - The connector is switched on by Avrix (see Availability); ask your Avrix contact
if the URL answers
404 Not Found. - Sign in with your Avrix account when the client asks; pick the company and what the assistant may do.
- Tools are scoped to that one company. To work on another company, connect again and pick it.
- Revoke access at any time under Profile → Connected apps; the assistant loses access immediately.
What the assistant can do#
| Tool family | Prefix | What it covers |
|---|---|---|
| Identity | avrix_ | avrix_whoami (who the connection acts as), avrix_list_my_companies |
| Seller API | seller_api_ | Catalog, pricing and quotes, orders, key pulls, refunds, chargebacks and disputes, webhooks and events, promotions, finance statements and ledger, integration diagnostics — Seller API operations for Content Seller companies; the full list is under Seller API tools |
Seller API tools appear only when you connected a Content Seller company and granted Seller API access. They run against the environment you chose at sign-in — sandbox (no real inventory) or production (real orders and keys) — and use a connector-managed API key that Avrix creates for the connection. You never see or paste that key; it is revoked with the connection.
Seller API tools follow the scopes of that key: a tool whose scope you did not grant answers
AUTH_MISSING_SCOPE and calls nothing.
Console tools for every company type (catalog, inventory, network, promotions, sales, finance, analytics, integrations, settings) appear in the same connection once enabled for your account. For Content Owners they cover the whole product lifecycle: creating products, editions, releases and SKUs, regional and SKU pricing, price tiers and templates, launch phase and trading state, business models, taxonomy and age ratings, store-description languages, publisher regions, Steam sync and structured bulk import. A single product-overview tool returns detail, releases with both catalog ids, pricing, price tier, sales readiness, inventory and Steam sync status in one call. Reads run immediately; every change is previewed and needs your approval before it runs.
Availability#
| Part | Status | How it is switched on |
|---|---|---|
Connector and sign-in (https://mcp.avrix.io/mcp) | Rolling out | Avrix switches it on per environment. While it is off, the URL answers 404 Not Found. |
Seller API tools (seller_api_) | Available wherever the connector is on | Connect a Content Seller company and grant Seller API access at sign-in. |
| Console tools, reading | Rolling out | Switched on by Avrix; until then they are not listed. |
| Console tools, changes | Rolling out after security review | Switched on by Avrix, and you must grant change access at sign-in. |
Nothing on this page needs a setting on your side beyond the sign-in choices. Key export is never
available through the connector: seller_api_export_keys is listed by clients but always refused.
Seller API tools#
Every tool below calls one or more Seller API operations with the connection's key. Read tools
never change data; Change tools do, and those marked "cannot be undone" are final. The same list,
with input fields and the operations each tool calls, is available at runtime from
seller_api_list_available_tools and seller_api_explain_tool.
Catalog
| Tool | What it does | Kind |
|---|---|---|
seller_api_search_products | Search the contract-gated catalog by free-text query, partner, or status. | Read |
seller_api_list_products | List products available from connected partners (paginated). | Read |
seller_api_get_product | Get product detail including editions, releases, and SKUs. | Read |
seller_api_list_editions | List editions for a product (derived from product detail). | Read |
seller_api_get_edition | Get a single edition for a product (derived from product detail). | Read |
seller_api_list_releases | List releases for a product (derived from product detail). | Read |
seller_api_get_release | Get a single release for a product (derived from product detail). | Read |
seller_api_list_regions | List territories visible through the seller's active allocations. | Read |
seller_api_get_region | Get a single region by ISO country code. | Read |
seller_api_list_platforms | List the platform codes a SKU can carry (platformCode, e.g. | Read |
Pricing and quotes
| Tool | What it does | Kind |
|---|---|---|
seller_api_get_product_pricing | Get regional pricing for a product (per release / country). | Read |
seller_api_list_partners | List vendor partners. | Read |
seller_api_list_partner_agreements | Read the agreed terms on one vendor connection. | Read |
seller_api_validate_price | Validate that a SKU can be sold in a country and return the authoritative price estimate (read-only order preview). | Read |
seller_api_create_order_quote | Produce a non-binding quote (price + fulfilment estimate) for a SKU, quantity and country without reserving inventory. | Read |
seller_api_validate_order | Dry-run an order to confirm eligibility (contract, region, currency, inventory) before committing. | Read |
Orders
| Tool | What it does | Kind |
|---|---|---|
seller_api_create_order | Create an order and receive keys (or reserve for pre-order). | Change |
seller_api_get_order | Get aggregated order state by store order id (orderReference). | Read |
seller_api_list_orders | List orders, newest first (paginated with cursor; filter by status and from/to). | Read |
seller_api_list_transactions | List key pull transactions. | Read |
seller_api_get_fulfilment_status | Summarize fulfilment for an order reference. | Read |
seller_api_cancel_order | Cancel a pre-order reservation by orderReference; returns reserved keys to available inventory. | Change, cannot be undone |
Keys and inventory
| Tool | What it does | Kind |
|---|---|---|
seller_api_check_key_availability | Check stock availability for one SKU (skuCode or skuId) or bulk skuCodes (comma-separated, max 50). | Read |
seller_api_get_inventory_summary | List seller allocations with quantity limits and wholesale terms (inventory overview). | Read |
seller_api_list_allocations | List seller allocations (quantity limits per SKU). | Read |
seller_api_pull_keys | Pull keys from an allocation (non-order flow). | Change |
seller_api_return_keys | Quarantine delivered keys after a refund or chargeback. | Change, cannot be undone |
Refunds, chargebacks and disputes
| Tool | What it does | Kind |
|---|---|---|
seller_api_list_refunds | List refund and chargeback adjustments, one row per key, newest sale first (paginated with cursor). | Read |
seller_api_get_refund | Read one refund or chargeback adjustment by refundId (from create_refund or list_refunds). | Read |
seller_api_create_refund | Record a refund or chargeback you already processed at your payment processor (Avrix never refunds the buyer). | Change, cannot be undone |
seller_api_resolve_chargeback | Report the outcome of a chargeback recorded with create_refund (type chargeback). | Change, cannot be undone |
seller_api_freeze_dispute_keys | Freeze delivered keys while a payment dispute is open. | Change |
seller_api_release_dispute_freeze | End a dispute freeze (freezeId from freeze_dispute_keys). | Change |
Account and webhooks
| Tool | What it does | Kind |
|---|---|---|
seller_api_get_seller_profile | Get the seller identity bound to the configured key. | Read |
seller_api_validate_seller_api_credentials | Validate the configured seller key without revealing the secret. | Read |
seller_api_get_seller_api_status | Get the Seller API health/status (database, cache, catalog index, queue). | Read |
seller_api_get_system_health | Get the Seller API component health probe (uptime, database, cache, catalog index, queue). | Read |
seller_api_list_seller_integrations | List the seller's registered webhook endpoints (integration outputs). | Read |
seller_api_list_webhooks | List registered webhook endpoints. | Read |
seller_api_list_webhook_deliveries | List delivery status for a webhook endpoint (debugging). | Read |
seller_api_list_supported_countries | List ISO country codes the seller can transact in (derived from active allocation regions). | Read |
Reports and finance
| Tool | What it does | Kind |
|---|---|---|
seller_api_get_settlement_summary | Get balances, draft report counts, and recent monthly settlement reports. | Read |
seller_api_get_sales_report | Get per-key API sale transaction rows for a period. | Read |
seller_api_get_revenue_report | Get API sale transaction rows used to compute revenue for a period. | Read |
seller_api_list_invoices | List seller invoices (paginated). | Read |
seller_api_get_key_consumption_report | Get key pull / consumption history for a period (from transactions). | Read |
seller_api_get_finance_statement | Monthly statement for one period (YYYY-MM). | Read |
seller_api_get_finance_ledger | Money ledger for one window, oldest first. | Read |
seller_api_get_api_sale_transaction | One API sale transaction by id. | Read |
seller_api_get_invoice_reconciliation | Reconciliation of one payout invoice as JSON. | Read |
seller_api_list_settlement_activity | Settlement activity feed, newest first. | Read |
Promotions
| Tool | What it does | Kind |
|---|---|---|
seller_api_get_promotions_summary | Promotions summary for the seller (counts of shares and deals). | Read |
seller_api_list_promotion_shares | List platform event promotion shares vendors offered you. | Read |
seller_api_get_promotion_share | Get a single promotion share by ID. | Read |
seller_api_accept_promotion_share | Accept a promotion share. | Change |
seller_api_decline_promotion_share | Decline a promotion share. | Change, cannot be undone |
seller_api_list_promotion_deals | List custom promotion deals. | Read |
seller_api_get_promotion_deal | Get a custom deal detail with products. | Read |
seller_api_respond_to_deal | Accept or reject a custom deal. | Change |
seller_api_get_promotions_calendar | Live and upcoming promotion windows by SKU (accepted shares and approved deals) with their priceEffect. | Read |
seller_api_list_promotion_share_discounts | SKU-level discounts of an accepted promotion share. | Read |
Integration and diagnostics
| Tool | What it does | Kind |
|---|---|---|
seller_api_list_webhook_event_types | List every webhook event type you can subscribe to, with its description. | Read |
seller_api_send_test_webhook | Queue a signed test delivery to one of your webhook endpoints through the normal delivery pipeline. | Change |
seller_api_retry_webhook_delivery | Queue a failed webhook delivery again with a fresh attempt cycle (endpointId and deliveryId from list_webhook_deliveries). | Change |
seller_api_list_events | Read the forward-only feed of your events (the events webhooks deliver). | Read |
seller_api_list_catalog_changes | Catalog change feed. | Read |
seller_api_get_catalog_checksum | Integrity digest of the catalog shared with you. | Read |
seller_api_list_availability_changes | Availability change feed. | Read |
seller_api_list_allocation_requests | List the allocation increase requests you sent to vendors and their decisions. | Read |
seller_api_request_allocation_increase | Ask the vendor for more keys on one allocation grant. | Change |
seller_api_list_allocation_replenishments | History of stock added to one allocation (allocationId from list_allocations). | Read |
seller_api_get_integration_status | Onboarding progress as one answer to "why can't I sell yet?". | Read |
seller_api_get_api_usage | Request counts for your key's environment over a UTC window (default the last 7 days), every response counted once. | Read |
seller_api_get_request | Redacted trace of one of your earlier requests by its X-Request-Id, with the webhook deliveries it produced. | Read |
Security model#
- Your identity, your permissions. Every tool runs as you, for the company you picked, with the permissions of your role in that company. An assistant cannot see more than you can.
- Explicit consent. The sign-in screen shows which app is asking, which company it will use, which tool families it gets and how many tools it sees (Essentials or Everything). Nothing is granted silently.
- Short-lived credentials. The client holds an access token valid for one hour and refreshes it in the background; refresh tokens rotate and expire after 30 days of inactivity (90 days at most).
- One revocation switch. Revoking under Profile → Connected apps kills the tokens and the connector-managed API key together. Blocked accounts lose all connections automatically.
- Approval before console changes. Console tools that change data never run on the assistant's say-so: the connector shows you a preview and waits for your approval, either as a prompt inside the client (where the client supports it) or as a confirmation the assistant has to carry back.
- Seller API changes are marked. Seller API tools run as soon as they are called, like the API
itself. Every tool that changes data is published as such (
readOnlyHint: false), and the ones that cannot be undone, such as recording a refund, also carrydestructiveHint: true; clients use these hints to ask you before running them. Try them on a sandbox connection first. - Untrusted output. Tool results are data from external systems. The connector tells the model so; treat anything an assistant "reads" from a product description or order note accordingly.
Limits#
- 60 requests per minute per user, 2,000 tool calls per connection per day (UTC). Clients receive a
429withRetry-Afterwhen a limit is hit. - Large results are truncated with a marker; ask the assistant to narrow the query.
- Results that cite console pages carry "Open in the Avrix console" links (MCP resource links) next to the data, including the two steps that stay in the console: importing keys for a SKU and uploading media for a product.
- One company per connection; production Seller API access requires the API model to be enabled for the company.
See Connect from your AI client for per-client steps and Sign-in and permissions for the authorization flow.