AI assistants and the Avrix MCP connector

Let Claude, ChatGPT, Cursor and other MCP clients work with your Avrix account: one URL, sign in, pick a company, revoke any time.

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 familyPrefixWhat it covers
Identityavrix_avrix_whoami (who the connection acts as), avrix_list_my_companies
Seller APIseller_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#

PartStatusHow it is switched on
Connector and sign-in (https://mcp.avrix.io/mcp)Rolling outAvrix 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 onConnect a Content Seller company and grant Seller API access at sign-in.
Console tools, readingRolling outSwitched on by Avrix; until then they are not listed.
Console tools, changesRolling out after security reviewSwitched 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

ToolWhat it doesKind
seller_api_search_productsSearch the contract-gated catalog by free-text query, partner, or status.Read
seller_api_list_productsList products available from connected partners (paginated).Read
seller_api_get_productGet product detail including editions, releases, and SKUs.Read
seller_api_list_editionsList editions for a product (derived from product detail).Read
seller_api_get_editionGet a single edition for a product (derived from product detail).Read
seller_api_list_releasesList releases for a product (derived from product detail).Read
seller_api_get_releaseGet a single release for a product (derived from product detail).Read
seller_api_list_regionsList territories visible through the seller's active allocations.Read
seller_api_get_regionGet a single region by ISO country code.Read
seller_api_list_platformsList the platform codes a SKU can carry (platformCode, e.g.Read

Pricing and quotes

ToolWhat it doesKind
seller_api_get_product_pricingGet regional pricing for a product (per release / country).Read
seller_api_list_partnersList vendor partners.Read
seller_api_list_partner_agreementsRead the agreed terms on one vendor connection.Read
seller_api_validate_priceValidate that a SKU can be sold in a country and return the authoritative price estimate (read-only order preview).Read
seller_api_create_order_quoteProduce a non-binding quote (price + fulfilment estimate) for a SKU, quantity and country without reserving inventory.Read
seller_api_validate_orderDry-run an order to confirm eligibility (contract, region, currency, inventory) before committing.Read

Orders

ToolWhat it doesKind
seller_api_create_orderCreate an order and receive keys (or reserve for pre-order).Change
seller_api_get_orderGet aggregated order state by store order id (orderReference).Read
seller_api_list_ordersList orders, newest first (paginated with cursor; filter by status and from/to).Read
seller_api_list_transactionsList key pull transactions.Read
seller_api_get_fulfilment_statusSummarize fulfilment for an order reference.Read
seller_api_cancel_orderCancel a pre-order reservation by orderReference; returns reserved keys to available inventory.Change, cannot be undone

Keys and inventory

ToolWhat it doesKind
seller_api_check_key_availabilityCheck stock availability for one SKU (skuCode or skuId) or bulk skuCodes (comma-separated, max 50).Read
seller_api_get_inventory_summaryList seller allocations with quantity limits and wholesale terms (inventory overview).Read
seller_api_list_allocationsList seller allocations (quantity limits per SKU).Read
seller_api_pull_keysPull keys from an allocation (non-order flow).Change
seller_api_return_keysQuarantine delivered keys after a refund or chargeback.Change, cannot be undone

Refunds, chargebacks and disputes

ToolWhat it doesKind
seller_api_list_refundsList refund and chargeback adjustments, one row per key, newest sale first (paginated with cursor).Read
seller_api_get_refundRead one refund or chargeback adjustment by refundId (from create_refund or list_refunds).Read
seller_api_create_refundRecord a refund or chargeback you already processed at your payment processor (Avrix never refunds the buyer).Change, cannot be undone
seller_api_resolve_chargebackReport the outcome of a chargeback recorded with create_refund (type chargeback).Change, cannot be undone
seller_api_freeze_dispute_keysFreeze delivered keys while a payment dispute is open.Change
seller_api_release_dispute_freezeEnd a dispute freeze (freezeId from freeze_dispute_keys).Change

Account and webhooks

ToolWhat it doesKind
seller_api_get_seller_profileGet the seller identity bound to the configured key.Read
seller_api_validate_seller_api_credentialsValidate the configured seller key without revealing the secret.Read
seller_api_get_seller_api_statusGet the Seller API health/status (database, cache, catalog index, queue).Read
seller_api_get_system_healthGet the Seller API component health probe (uptime, database, cache, catalog index, queue).Read
seller_api_list_seller_integrationsList the seller's registered webhook endpoints (integration outputs).Read
seller_api_list_webhooksList registered webhook endpoints.Read
seller_api_list_webhook_deliveriesList delivery status for a webhook endpoint (debugging).Read
seller_api_list_supported_countriesList ISO country codes the seller can transact in (derived from active allocation regions).Read

Reports and finance

ToolWhat it doesKind
seller_api_get_settlement_summaryGet balances, draft report counts, and recent monthly settlement reports.Read
seller_api_get_sales_reportGet per-key API sale transaction rows for a period.Read
seller_api_get_revenue_reportGet API sale transaction rows used to compute revenue for a period.Read
seller_api_list_invoicesList seller invoices (paginated).Read
seller_api_get_key_consumption_reportGet key pull / consumption history for a period (from transactions).Read
seller_api_get_finance_statementMonthly statement for one period (YYYY-MM).Read
seller_api_get_finance_ledgerMoney ledger for one window, oldest first.Read
seller_api_get_api_sale_transactionOne API sale transaction by id.Read
seller_api_get_invoice_reconciliationReconciliation of one payout invoice as JSON.Read
seller_api_list_settlement_activitySettlement activity feed, newest first.Read

Promotions

ToolWhat it doesKind
seller_api_get_promotions_summaryPromotions summary for the seller (counts of shares and deals).Read
seller_api_list_promotion_sharesList platform event promotion shares vendors offered you.Read
seller_api_get_promotion_shareGet a single promotion share by ID.Read
seller_api_accept_promotion_shareAccept a promotion share.Change
seller_api_decline_promotion_shareDecline a promotion share.Change, cannot be undone
seller_api_list_promotion_dealsList custom promotion deals.Read
seller_api_get_promotion_dealGet a custom deal detail with products.Read
seller_api_respond_to_dealAccept or reject a custom deal.Change
seller_api_get_promotions_calendarLive and upcoming promotion windows by SKU (accepted shares and approved deals) with their priceEffect.Read
seller_api_list_promotion_share_discountsSKU-level discounts of an accepted promotion share.Read

Integration and diagnostics

ToolWhat it doesKind
seller_api_list_webhook_event_typesList every webhook event type you can subscribe to, with its description.Read
seller_api_send_test_webhookQueue a signed test delivery to one of your webhook endpoints through the normal delivery pipeline.Change
seller_api_retry_webhook_deliveryQueue a failed webhook delivery again with a fresh attempt cycle (endpointId and deliveryId from list_webhook_deliveries).Change
seller_api_list_eventsRead the forward-only feed of your events (the events webhooks deliver).Read
seller_api_list_catalog_changesCatalog change feed.Read
seller_api_get_catalog_checksumIntegrity digest of the catalog shared with you.Read
seller_api_list_availability_changesAvailability change feed.Read
seller_api_list_allocation_requestsList the allocation increase requests you sent to vendors and their decisions.Read
seller_api_request_allocation_increaseAsk the vendor for more keys on one allocation grant.Change
seller_api_list_allocation_replenishmentsHistory of stock added to one allocation (allocationId from list_allocations).Read
seller_api_get_integration_statusOnboarding progress as one answer to "why can't I sell yet?".Read
seller_api_get_api_usageRequest counts for your key's environment over a UTC window (default the last 7 days), every response counted once.Read
seller_api_get_requestRedacted 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 carry destructiveHint: 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 429 with Retry-After when 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.

What links here

Published guides that link to this page.

Search docs

Search documentation…