Liigu sisu juurde

MCP server

Connect an AI assistant to the Marketplace. The server speaks the Model Context Protocol over Streamable HTTP, authorizes with OAuth 2.1, and exposes the same actions your dashboard does — nothing more than the access you grant.

Valige oma poolÜhendun kui

Müüja agent tegutseb teie poes — tooted, laoseis, tellimused — ja kinnitatakse müüja töölaual.

  • TransportStreamable HTTP
  • AutoriseerimineOAuth 2.1 + PKCE (S256)
  • Tööriistad57 müüja30 ostja
  • Serveri URLhttps://marketplace-mcp.paysera.com/seller/mcp

Seda lehte pole veel tõlgitud — sa loed ingliskeelset versiooni.

Quick start

Four steps, one browser approval. Nothing is granted until you approve.

urlServeri URL
https://marketplace-mcp.paysera.com/seller/mcp
  1. Add the server

    Paste the server URL into your client (per-client steps below).

  2. Approve in your dashboard

    On first use your client opens a browser window. Sign in to the seller dashboard and approve the pending request under Agents.

  3. Choose what it may do

    Pick the capabilities and level — products, stock, orders — and optionally limit it to one store.

  4. Ask

    Your assistant now sees only the tools your grant allows. Change or revoke the grant any time.

  1. Add the server

    Paste the server URL into your client (per-client steps below).

  2. Approve in your dashboard

    On first use your client opens a browser window. Sign in to the Marketplace and approve the request under Agents.

  3. Choose what it may do

    Pick the capabilities and level — browsing, cart, ordering — and a spending mandate if it may order.

  4. Ask

    Your assistant now sees only the tools your grant allows. Change or revoke the grant any time.

What it is

MCP is the open protocol AI assistants use to call tools. Our server turns the Marketplace into a set of tools an assistant can use on your behalf — listing a product, adjusting stock, answering a reviewfinding a product, filling a cart, placing an order — with the same rules and the same access checks as the dashboard.

Two separate servers live on one host, one per audience. The path selects the audience; there is no shared root.

AudienceServer URLApproved from
Seller agentshttps://marketplace-mcp.paysera.com/seller/mcpSeller dashboard → Team & access → Agents
Buyer agentshttps://marketplace-mcp.paysera.com/buyer/mcpMarketplace app → Agents

Connect your client

Every client below supports remote MCP servers over Streamable HTTP with OAuth. Use the entry that matches yours. They all end the same way: on first use your client opens a browser window; approve the request in your dashboard and the connection completes.

Hoiatus

The top-level key differs by client: Claude Code and Cursor read mcpServers; VS Code reads servers and needs "type": "http". Copy the snippet for your client, not a neighbour's.

Claude Desktop

  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it paysera-marketplace and paste the server URL: https://marketplace-mcp.paysera.com/seller/mcp
  3. Choose Add. Claude opens your dashboard in the browser; approve the request and return to Claude.

Claude Desktop needs no configuration file.

Claude Code

bashTerminal
claude mcp add --transport http paysera-marketplace https://marketplace-mcp.paysera.com/seller/mcp
# then, inside a session:
/mcp   # opens the browser for the one-time approval

Cursor

Add the entry to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project.

json.cursor/mcp.json
{
  "mcpServers": {
    "paysera-marketplace": {
      "url": "https://marketplace-mcp.paysera.com/seller/mcp"
    }
  }
}

VS Code

Add the entry to .vscode/mcp.json. Note the different top-level key.

json.vscode/mcp.json
{
  "servers": {
    "paysera-marketplace": {
      "type": "http",
      "url": "https://marketplace-mcp.paysera.com/seller/mcp"
    }
  }
}

Codex CLI

Add the server to ~/.codex/config.toml, then run codex mcp login paysera-marketplace for the browser approval.

toml~/.codex/config.toml
[mcp_servers.paysera-marketplace]
url = "https://marketplace-mcp.paysera.com/seller/mcp"

ChatGPT

  1. Open Settings → Connectors and enable Developer mode.
  2. Choose Create, name it Paysera Marketplace and paste the server URL: https://marketplace-mcp.paysera.com/seller/mcp
  3. Select OAuth as the authentication and save.

TypeScript and Python SDKs

Building your own agent? Use the official MCP SDKs with the Streamable HTTP transport and an OAuth client provider. The provider handles discovery, registration and the browser approval.

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://marketplace-mcp.paysera.com/seller/mcp"),
  { authProvider },   // your OAuthClientProvider: PKCE S256, opens the approval URL
);
const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

const me = await client.callTool({ name: "marketplace_whoami", arguments: {} });

How authorization works

The server is its own OAuth 2.1 authorization server, one issuer per audience. Standard clients need no configuration beyond the URL — the flow below happens automatically.

  1. Discover

    The client reads /.well-known/oauth-protected-resource/seller/mcp and the authorization-server metadata it points to.

  2. Register

    It registers itself with POST /oauth/seller/register (dynamic client registration) and receives a client id.

  3. Authorize

    It generates a PKCE pair (S256 only) and opens /oauth/seller/authorize in your browser.

  4. Approve

    You sign in to your dashboard and approve the request, choosing its capabilities. The client polls until you do.

  5. Tokens

    It exchanges the code at /oauth/seller/token for a short-lived access token and a refresh token, bound to this server URL.

Your client never sees a Paysera token or the agent secret. The MCP server keeps them. The client only holds tokens issued by the MCP server, valid for one server URL, and they expire after 5 minutes (refresh is automatic).

EndpointPurpose
GET /.well-known/oauth-protected-resource/seller/mcpWhich authorization server protects this server URL
GET /.well-known/oauth-authorization-server/oauth/sellerIssuer metadata: endpoints, grants, PKCE methods
POST /oauth/seller/registerDynamic client registration (RFC 7591)
GET /oauth/seller/authorizeStarts the browser approval; polls until approved
POST /oauth/seller/tokenCode exchange, refresh, and client credentials
jsonVastus · GET /.well-known/oauth-authorization-server/oauth/seller
{
  "issuer": "https://marketplace-mcp.paysera.com/oauth/seller",
  "authorization_endpoint": "https://marketplace-mcp.paysera.com/oauth/seller/authorize",
  "token_endpoint": "https://marketplace-mcp.paysera.com/oauth/seller/token",
  "registration_endpoint": "https://marketplace-mcp.paysera.com/oauth/seller/register",
  "response_types_supported": [
    "code"
  ],
  "grant_types_supported": [
    "authorization_code",
    "refresh_token",
    "client_credentials"
  ],
  "code_challenge_methods_supported": [
    "S256"
  ],
  "token_endpoint_auth_methods_supported": [
    "none",
    "client_secret_post"
  ]
}

Supported grants: authorization_code with PKCE for interactive clients, refresh_token, and client_credentials for a headless agent you created in the dashboard. Authorization codes are single-use and expire after 60 seconds; a pending approval waits up to 10 minutes.

Register and approve an agent

An agent is a delegated identity with its own credential and its own grant. There are two ways to create one.

A — Let the client register itself

This is what the quick start does. The client registers, you get a pending request in your dashboard, and you approve it with the access you want. If your client shows a pairing code instead of opening a browser, enter it in the dashboard under Team & access → Agents → ConnectAgents → Connect.

B — Create the agent yourself

For a server-side integration with no browser, create the agent in the dashboard first. You get a client id (agt_…) and a secret shown on demandexactly once. The integration then uses the client_credentials grant at the token endpoint and connects with the resulting bearer token.

bashJuurdepääsuluba ilma brauserita (client credentials)
curl -X POST https://marketplace-mcp.paysera.com/oauth/seller/token \
  -d grant_type=client_credentials \
  -d client_id=agt_7tvsvcagent0001 \
  -d client_secret=$AGENT_SECRET \
  -d resource=https://marketplace-mcp.paysera.com/seller/mcp

Grants are per capability area — products, stock, orders, and pricing — at read or read_write, for the whole account or one store. An agent's effective access is always its grant intersected with the live access of the person who approved it.

Grants are per area — browse_search, cart_wishlist, ordering, order_tracking, profile_addresses. An agent may only place orders when ordering is read_write, which requires a spending mandate: a per-order cap and a monthly cap, in euro cents.

Ava oma töölaual agentide leht ↗

Manage, pause or revoke an agent

Every connected agent is listed on the Agents page of your dashboard with what it may do and when it was last used. From its detail page you can change its grant, pause it (tokens stop working until you resume) or revoke it (its credential is disabled and cannot be restored). Grant the smallest access that does the job — read where the assistant only needs to look.

Hoiatus

Treat tool calls like actions by a colleague. Keep your client's tool-confirmation setting on for write tools, and be wary of content that asks the assistant to "ignore its instructions" — product descriptions and reviews are untrusted text. If your company filters outbound traffic, ask IT to allow https://marketplace-mcp.paysera.com.

Available tools

Every tool wraps one dashboard action and is named marketplace_<verb>_<object>. Your assistant only sees the tools your grant allows; the platform re-checks access on every call.

57 tööriista 12 rühmas

Self

always available1 tööriist
marketplace_whoamireadReport this agent's own effective access: surface, account, capability or scope levels, store scope, status, expiry and any spending-mandate head-room.

Sisendparameetreid ei ole.

Account

always available2 tööriista
marketplace_list_storesreadList the stores on the seller's account. Pass the accountId reported by marketplace_whoami.

Parameetrid

  • accountIdstringkohustuslik
marketplace_get_storereadGet the details of one of the seller stores by its store id.

Parameetrid

  • storeIdstringkohustuslik

Catalog knowledge

always available3 tööriista
marketplace_get_categoriesreadGet the marketplace category tree, to choose a category when creating or editing a product.

Sisendparameetreid ei ole.

marketplace_get_category_attributesreadGet the attributes a product in a given category can carry.

Parameetrid

  • categoryIdstringkohustuslik
marketplace_list_brandsreadList the marketplace brands a product can be assigned to.

Sisendparameetreid ei ole.

Products — reads

products: read4 tööriista
marketplace_list_productsreadList the products in a store, newest first, with cursor paging.

Parameetrid

  • storeIdstringkohustuslik
  • limitinteger
  • cursorstring
marketplace_get_productreadGet one product with its variants by product id.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
marketplace_get_product_statsreadGet the product counts for a store, grouped by lifecycle state.

Parameetrid

  • storeIdstringkohustuslik
marketplace_get_variantreadGet one product variant by variant id.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik

Products — writes

products: read_write14 tööriista
marketplace_create_productwriteCreate a product with its options, attributes and variants (including each variant price).

Parameetrid

  • storeIdstringkohustuslik
  • titlestringkohustuslik
  • descriptionstringkohustuslik
  • categoryIdstringkohustuslik
  • brandIdstring
  • sourcestringkohustuslik
  • inventoryTrackedbooleankohustuslik
  • optionsarraykohustuslik
  • attributesarraykohustuslik
  • variantsarraykohustuslik
marketplace_update_product_detailswriteRename a product or rewrite its description. Provide exactly one of title or description per call.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • titlestring
  • descriptionstring
marketplace_set_product_categorywriteSet a product's category.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • categoryIdstringkohustuslik
marketplace_set_product_brandwriteSet a product's brand.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • brandIdstringkohustuslik
marketplace_set_product_attributeswriteSet a product's attribute values for its category.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • attributesarraykohustuslik
marketplace_add_variantwriteAdd one variant to a product from a combination of option values.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • optionValueIdsarraykohustuslik
marketplace_generate_variantswriteGenerate a matrix of variants for a product from option combinations.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • newOptionValuesarraykohustuslik
  • combinationsarraykohustuslik
marketplace_update_variant_detailswriteUpdate a variant's SKU and/or barcodes.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik
  • skustring
  • barcodesarray
marketplace_publish_variantwritePublish a variant so it can qualify to sell.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik
marketplace_unpublish_variantwriteUnpublish a variant so it stops qualifying to sell.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik
marketplace_enable_variantwriteEnable a variant so it is active.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik
marketplace_disable_variantwriteDisable a variant so it is inactive.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik
marketplace_archive_variantwriteArchive a variant. Reversible with marketplace_restore_variant.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik
marketplace_restore_variantwriteRestore a previously archived variant.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik

Stock

stock: read / read_write8 tööriista
marketplace_list_stock_itemsreadList the stock items (SKU inventory) for a store, with cursor paging.

Parameetrid

  • storeIdstringkohustuslik
  • limitinteger
  • cursorstring
marketplace_get_inventoryreadGet the on-hand inventory balances for a store.

Parameetrid

  • storeIdstringkohustuslik
marketplace_list_stock_movementsreadList the stock movement ledger for a store, with cursor paging.

Parameetrid

  • storeIdstringkohustuslik
  • limitinteger
  • cursorstring
marketplace_list_warehousesreadList the warehouses stock is held in for a store.

Parameetrid

  • storeIdstringkohustuslik
marketplace_create_stock_itemwriteCreate a stock item (a tracked SKU with its name).

Parameetrid

  • storeIdstringkohustuslik
  • skustringkohustuslik
  • namestringkohustuslik
  • externalReferencestring
marketplace_set_stock_balancewriteSet the on-hand balance of a stock item at a warehouse to an absolute quantity.

Parameetrid

  • storeIdstringkohustuslik
  • stockItemIdstringkohustuslik
  • warehouseIdstringkohustuslik
  • quantityintegerkohustuslik
marketplace_create_stock_adjustmentwriteDraft a stock adjustment at a warehouse; post it separately to apply it. Each line carries a signed quantity change, never zero: negative takes units out. When setting an absolute total, pass each line’s expectedOnHand (the on-hand you read): posting then fails with a conflict and applies nothing if the stock moved since.

Parameetrid

  • storeIdstringkohustuslik
  • warehouseIdstringkohustuslik
  • reasonCodestringkohustuslikÜks järgnevatest: DAMAGE · LOSS · FOUND · CORRECTION · RECOUNT · QUALITY_HOLD · QUALITY_RELEASE
  • notesstring
  • linesarraykohustuslik
marketplace_post_stock_adjustmentwritePost a drafted stock adjustment so its quantity changes take effect.

Parameetrid

  • storeIdstringkohustuslik
  • adjustmentIdstringkohustuslik

Orders & customers

orders: read / read_write10 tööriista
marketplace_list_ordersreadList the orders on a store, newest first, with cursor paging.

Parameetrid

  • storeIdstringkohustuslik
  • limitinteger
  • cursorstring
marketplace_get_order_countsreadGet the order counts for a store, grouped by status.

Parameetrid

  • storeIdstringkohustuslik
marketplace_get_orderreadGet one order in full by order id.

Parameetrid

  • storeIdstringkohustuslik
  • orderIdstringkohustuslik
marketplace_get_order_timelinereadGet one order timeline (its lifecycle events) by order id.

Parameetrid

  • storeIdstringkohustuslik
  • orderIdstringkohustuslik
marketplace_cancel_orderwriteCancel an order as the seller, with an optional reason.

Parameetrid

  • storeIdstringkohustuslik
  • orderIdstringkohustuslik
  • reasonstring
marketplace_advance_shipmentwriteAdvance a shipment to its next fulfilment state.

Parameetrid

  • storeIdstringkohustuslik
  • orderIdstringkohustuslik
  • shipmentIdstringkohustuslik
marketplace_list_customersreadList a store customers (its CRM), with cursor paging.

Parameetrid

  • storeIdstringkohustuslik
  • limitinteger
  • cursorstring
marketplace_get_customerreadGet one customer CRM record by customer id.

Parameetrid

  • storeIdstringkohustuslik
  • customerIdstringkohustuslik
marketplace_add_customer_notewriteSet the seller-private note on a customer CRM record.

Parameetrid

  • storeIdstringkohustuslik
  • customerIdstringkohustuslik
  • notestringkohustuslik
marketplace_tag_customerwriteAdd a tag to a customer CRM record.

Parameetrid

  • storeIdstringkohustuslik
  • customerIdstringkohustuslik
  • labelstringkohustuslik

Reviews

orders: read / read_write3 tööriista
marketplace_list_reviewsreadList the store customer reviews, newest first, with cursor paging.

Parameetrid

  • storeIdstringkohustuslik
  • limitinteger
  • cursorstring
marketplace_get_review_summaryreadGet the review summary for a store: average rating and rating distribution.

Parameetrid

  • storeIdstringkohustuslik
marketplace_respond_to_reviewwritePost the seller public response to a customer review.

Parameetrid

  • storeIdstringkohustuslik
  • reviewIdstringkohustuslik
  • messagestringkohustuslik

AI assist

products: read4 tööriista
marketplace_identify_productreadIdentify a product from a text query and/or barcodes: category, brand, match candidates, price band.

Parameetrid

  • querystring
  • barcodesarray
marketplace_match_catalog_productsreadFind canonical catalog products matching a grounded identification or intent.

Parameetrid

  • modestringkohustuslik
  • groundedobject
  • intentobject
  • sellerStoreIdstring
  • limitinteger
  • minConfidencenumber
marketplace_get_catalog_product_detailreadGet the matched canonical catalog product detail by product id.

Parameetrid

  • productIdstringkohustuslik
marketplace_suggest_variantsreadSuggest variant candidates for a matched catalog product in a category.

Parameetrid

  • productIdstringkohustuslik
  • categoryIdstringkohustuslik
  • intentobject

Import & CMS

products: read / read_write6 tööriista
marketplace_start_importwriteStage a catalog CSV import from an uploaded file; confirm it to apply.

Parameetrid

  • storeIdstringkohustuslik
  • uploadIdstringkohustuslik
marketplace_get_import_statusreadGet one import status and its row-level errors by import id.

Parameetrid

  • storeIdstringkohustuslik
  • importIdstringkohustuslik
marketplace_confirm_importwriteCommit a staged catalog import so its rows are applied.

Parameetrid

  • storeIdstringkohustuslik
  • importIdstringkohustuslik
marketplace_get_cms_connectionreadGet the CMS connection for a store, including its connectionId.

Parameetrid

  • storeIdstringkohustuslik
marketplace_trigger_cms_importwriteTrigger a catalog sync from a connected CMS (WooCommerce / Shopify).

Parameetrid

  • storeIdstringkohustuslik
  • connectionIdstringkohustuslik
marketplace_get_cms_sync_statusreadGet the CMS sync jobs for a connection: their progress and outcomes.

Parameetrid

  • storeIdstringkohustuslik
  • connectionIdstringkohustuslik

Pricing

pricing: read_write1 tööriist
marketplace_set_variant_pricewriteSet a variant's price (in cents), within the owner's repricing bound.

Parameetrid

  • storeIdstringkohustuslik
  • productIdstringkohustuslik
  • variantIdstringkohustuslik
  • priceAmountintegerkohustuslik
  • priceCurrencystringkohustuslik

Media

products: read_write1 tööriist
marketplace_upload_filewriteUpload a product image (JPEG, PNG or WebP, base64) and get an uploadId to attach it to a product.

Parameetrid

  • fileNamestringkohustuslik
  • mimeTypestringkohustuslik
  • contentBase64stringkohustuslik

Tool detail

marketplace_set_variant_price — Set a variant's price (in cents), within the owner's repricing bound. Needs pricing: read_write; hidden unless that capability is granted.

ParameterTypeRequiredNotes
storeIdstringyesStore the product belongs to
productIdstringyes
variantIdstringyes
priceAmountintegeryesEuro cents, positive — 119900 is €1,199.00
priceCurrencystringyesISO 4217, three letters — EUR
jsonExample call
{
"name": "marketplace_set_variant_price",
"arguments": {
  "storeId": "01914d0e-7f3a-7c2e-9d51-6b0f2a4c8e11",
  "productId": "01914d0e-8a1b-7d3f-a2c4-5e6f7a8b9c0d",
  "variantId": "01914d0e-9b2c-7e4a-b3d5-6f7a8b9c0d1e",
  "priceAmount": 119900,
  "priceCurrency": "EUR"
}
}

A price outside the repricing bound the owner set is rejected in the tool result — the assistant is told the bound, not the platform.

Placing an order is always two tools. marketplace_review_checkout returns the total and a one-time confirmation token and changes nothing; marketplace_confirm_checkout places the order and is rejected if anything changed since the review.

ParameterTypeRequiredNotes
intentIdstringyesFrom marketplace_open_purchase_intent
expectedTotalAmountCentsintegeryesExactly the total the review reported
confirmationTokenstringyesIssued by the review; single use, bound to this intent and total
paymentMethodKeystringyesFrom marketplace_get_store_payment_methods
paymentFlow, paymentCountryCode, platformstringnoProvider hints
jsonStep 1 — review (changes nothing)
{
"name": "marketplace_review_checkout",
"arguments": {
  "intentId": "01914d0e-7f3a-7c2e-9d51-6b0f2a4c8e11"
}
}
jsonReview result (excerpt)
{
"intentId": "01914d0e-7f3a-7c2e-9d51-6b0f2a4c8e11",
"store": "TechVault",
"totalAmountCents": 129900,
"currency": "EUR",
"confirmationToken": "cft_7f3a…",
"items": [
  {
    "title": "iPhone 17 Pro Max · 256 GB",
    "quantity": 1,
    "unitAmountCents": 129900
  }
]
}
jsonStep 2 — confirm (places the order)
{
"name": "marketplace_confirm_checkout",
"arguments": {
  "intentId": "01914d0e-7f3a-7c2e-9d51-6b0f2a4c8e11",
  "expectedTotalAmountCents": 129900,
  "confirmationToken": "cft_7f3a…",
  "paymentMethodKey": "paysera_card"
}
}

An order above the agent's per-order or monthly cap is rejected with a pointer to the Agents page, where the mandate can be raised.

Typical workflows

Things people ask their assistant, and the tools behind them:

  • Create a product for this box of running shoes from the photos, in size 40 to 45, at €89.
  • Which orders from this week are still unshipped? Advance the ones with a printed label.
  • Set stock of SKU TV-IPH17-256 to 41 in the Vilnius warehouse.
  • Find a 256 GB iPhone 17 Pro under €1,300 with delivery by Friday and add the cheapest offer to my cart.
  • Show my last five orders and where the latest one is.
  • Check out my cart to my home address and pay with the saved card — but show me the total first.

List a product from a photo

  1. marketplace_upload_file — upload the photo, get an uploadId
  2. marketplace_identify_product — category, brand and match candidates from the photo or a text query
  3. marketplace_match_catalog_products → marketplace_suggest_variants — pick the canonical product and its variants
  4. marketplace_create_product — create it with options, attributes and variant prices
  5. marketplace_publish_variant — publish each variant so it can qualify to sell

Keep stock in sync from your system

  1. marketplace_list_warehouses — find the warehouse id
  2. marketplace_set_stock_balance — set the absolute on-hand quantity per SKU
  3. or marketplace_create_stock_adjustment → marketplace_post_stock_adjustment — relative changes, drafted then posted

Fill a cart and check out

  1. marketplace_search_products — natural-language search across all sellers
  2. marketplace_get_product — compare the qualifying offers per variant
  3. marketplace_add_cart_item — add the chosen seller's listing
  4. marketplace_open_purchase_intent — start checkout for that seller group
  5. marketplace_list_addresses → marketplace_set_delivery_address → marketplace_set_fulfillment_option
  6. marketplace_review_checkout → marketplace_confirm_checkout — show the total, then place the order

Track an order

  1. marketplace_list_orders — active, completed or cancelled
  2. marketplace_get_order — items, shipments and timeline
  3. marketplace_track_order — payment confirmation status and retry options

Errors and limits

What you seeWhyWhat to do
401 from the serverThe access token expired (5 minutes) or is for another server URLClients refresh automatically; a headless integration requests a new token
404 at /mcpThe bare path is not a serverUse /seller/mcp or /buyer/mcp
Tool result: "not permitted"The grant lacks that capability or levelWiden it on the Agents page; the tool appears on the next connection
Tool result: "changed since review" (buyer)Total or items changed between review and confirmReview again and confirm with the new token
Tool result: "outside the repricing bound" (seller)The price is beyond the bound the owner set for agentsAsk the owner to widen the bound, or stay inside it
Any failed actionReported inside the tool result with a reason — never as HTTP 500Read the reason; your assistant can explain it

Environments

EnvironmentHostNotes
Staginghttps://marketplace-mcp.paysera.comTest data only — nothing you do here ships or charges anyone.
Production—Announced with launch. Production agents act on real orders and real money.