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.
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 startLink sellele jaotisele:
Four steps, one browser approval. Nothing is granted until you approve.
https://marketplace-mcp.paysera.com/seller/mcpAdd the server
Paste the server URL into your client (per-client steps below).
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.
Choose what it may do
Pick the capabilities and level — products, stock, orders — and optionally limit it to one store.
Ask
Your assistant now sees only the tools your grant allows. Change or revoke the grant any time.
Add the server
Paste the server URL into your client (per-client steps below).
Approve in your dashboard
On first use your client opens a browser window. Sign in to the Marketplace and approve the request under Agents.
Choose what it may do
Pick the capabilities and level — browsing, cart, ordering — and a spending mandate if it may order.
Ask
Your assistant now sees only the tools your grant allows. Change or revoke the grant any time.
What it isLink sellele jaotisele:
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.
| Audience | Server URL | Approved from |
|---|---|---|
| Seller agents | https://marketplace-mcp.paysera.com/seller/mcp | Seller dashboard → Team & access → Agents |
| Buyer agents | https://marketplace-mcp.paysera.com/buyer/mcp | Marketplace app → Agents |
Connect your clientLink sellele jaotisele:
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.
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 DesktopLink sellele jaotisele:
- Open Settings → Connectors and choose Add custom connector.
- Name it
paysera-marketplaceand paste the server URL:https://marketplace-mcp.paysera.com/seller/mcp - Choose Add. Claude opens your dashboard in the browser; approve the request and return to Claude.
Claude Desktop needs no configuration file.
Claude CodeLink sellele jaotisele:
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 approvalCursorLink sellele jaotisele:
Add the entry to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project.
{
"mcpServers": {
"paysera-marketplace": {
"url": "https://marketplace-mcp.paysera.com/seller/mcp"
}
}
}VS CodeLink sellele jaotisele:
Add the entry to .vscode/mcp.json. Note the different top-level key.
{
"servers": {
"paysera-marketplace": {
"type": "http",
"url": "https://marketplace-mcp.paysera.com/seller/mcp"
}
}
}Codex CLILink sellele jaotisele:
Add the server to ~/.codex/config.toml, then run codex mcp login paysera-marketplace for the
browser approval.
[mcp_servers.paysera-marketplace]
url = "https://marketplace-mcp.paysera.com/seller/mcp"ChatGPTLink sellele jaotisele:
- Open Settings → Connectors and enable Developer mode.
- Choose Create, name it
Paysera Marketplaceand paste the server URL:https://marketplace-mcp.paysera.com/seller/mcp - Select OAuth as the authentication and save.
TypeScript and Python SDKsLink sellele jaotisele:
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: {} });from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
async with streamablehttp_client("https://marketplace-mcp.paysera.com/seller/mcp", auth=auth_provider) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
me = await session.call_tool("marketplace_whoami", {})Link sellele jaotisele:
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.
Discover
The client reads
/.well-known/oauth-protected-resource/seller/mcpand the authorization-server metadata it points to.Register
It registers itself with
POST /oauth/seller/register(dynamic client registration) and receives a client id.Authorize
It generates a PKCE pair (S256 only) and opens
/oauth/seller/authorizein your browser.Approve
You sign in to your dashboard and approve the request, choosing its capabilities. The client polls until you do.
Tokens
It exchanges the code at
/oauth/seller/tokenfor 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).
| Endpoint | Purpose |
|---|---|
GET /.well-known/oauth-protected-resource/seller/mcp | Which authorization server protects this server URL |
GET /.well-known/oauth-authorization-server/oauth/seller | Issuer metadata: endpoints, grants, PKCE methods |
POST /oauth/seller/register | Dynamic client registration (RFC 7591) |
GET /oauth/seller/authorize | Starts the browser approval; polls until approved |
POST /oauth/seller/token | Code exchange, refresh, and client credentials |
{
"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 agentLink sellele jaotisele:
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 itselfLink sellele jaotisele:
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 yourselfLink sellele jaotisele:
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.
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/mcpGrants 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.
Manage, pause or revoke an agentLink sellele jaotisele:
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.
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 toolsLink sellele jaotisele:
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.
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 detailLink sellele jaotisele:
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
storeId | string | yes | Store the product belongs to |
productId | string | yes | |
variantId | string | yes | |
priceAmount | integer | yes | Euro cents, positive — 119900 is €1,199.00 |
priceCurrency | string | yes | ISO 4217, three letters — EUR |
{
"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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
intentId | string | yes | From marketplace_open_purchase_intent |
expectedTotalAmountCents | integer | yes | Exactly the total the review reported |
confirmationToken | string | yes | Issued by the review; single use, bound to this intent and total |
paymentMethodKey | string | yes | From marketplace_get_store_payment_methods |
paymentFlow, paymentCountryCode, platform | string | no | Provider hints |
{
"name": "marketplace_review_checkout",
"arguments": {
"intentId": "01914d0e-7f3a-7c2e-9d51-6b0f2a4c8e11"
}
}{
"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
}
]
}{
"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 workflowsLink sellele jaotisele:
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 photoLink sellele jaotisele:
marketplace_upload_file— upload the photo, get anuploadIdmarketplace_identify_product— category, brand and match candidates from the photo or a text querymarketplace_match_catalog_products→marketplace_suggest_variants— pick the canonical product and its variantsmarketplace_create_product— create it with options, attributes and variant pricesmarketplace_publish_variant— publish each variant so it can qualify to sell
Keep stock in sync from your systemLink sellele jaotisele:
marketplace_list_warehouses— find the warehouse idmarketplace_set_stock_balance— set the absolute on-hand quantity per SKU- or
marketplace_create_stock_adjustment→marketplace_post_stock_adjustment— relative changes, drafted then posted
Fill a cart and check outLink sellele jaotisele:
marketplace_search_products— natural-language search across all sellersmarketplace_get_product— compare the qualifying offers per variantmarketplace_add_cart_item— add the chosen seller's listingmarketplace_open_purchase_intent— start checkout for that seller groupmarketplace_list_addresses→marketplace_set_delivery_address→marketplace_set_fulfillment_optionmarketplace_review_checkout→marketplace_confirm_checkout— show the total, then place the order
Track an orderLink sellele jaotisele:
marketplace_list_orders— active, completed or cancelledmarketplace_get_order— items, shipments and timelinemarketplace_track_order— payment confirmation status and retry options
Errors and limitsLink sellele jaotisele:
| What you see | Why | What to do |
|---|---|---|
401 from the server | The access token expired (5 minutes) or is for another server URL | Clients refresh automatically; a headless integration requests a new token |
404 at /mcp | The bare path is not a server | Use /seller/mcp or /buyer/mcp |
| Tool result: "not permitted" | The grant lacks that capability or level | Widen 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 confirm | Review again and confirm with the new token |
| Tool result: "outside the repricing bound" (seller) | The price is beyond the bound the owner set for agents | Ask the owner to widen the bound, or stay inside it |
| Any failed action | Reported inside the tool result with a reason — never as HTTP 500 | Read the reason; your assistant can explain it |
EnvironmentsLink sellele jaotisele:
| Environment | Host | Notes |
|---|---|---|
| Staging | https://marketplace-mcp.paysera.com | Test data only — nothing you do here ships or charges anyone. |
| Production | — | Announced with launch. Production agents act on real orders and real money. |