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.
Pardavėjo agentas veikia jūsų parduotuvėje — prekės, atsargos, užsakymai — ir tvirtinamas pardavėjo skydelyje.
- PerdavimasStreamable HTTP
- AutorizacijaOAuth 2.1 + PKCE (S256)
- Įrankiai57 pardavėjo30 pirkėjo
- Serverio URLhttps://marketplace-mcp.paysera.com/seller/mcp
Šis puslapis dar neišverstas — skaitote versiją anglų kalba.
Quick startNuoroda į šį skyrių:
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 isNuoroda į šį skyrių:
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 clientNuoroda į šį skyrių:
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 DesktopNuoroda į šį skyrių:
- 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 CodeNuoroda į šį skyrių:
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 approvalCursorNuoroda į šį skyrių:
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 CodeNuoroda į šį skyrių:
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 CLINuoroda į šį skyrių:
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"ChatGPTNuoroda į šį skyrių:
- 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 SDKsNuoroda į šį skyrių:
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", {})Nuoroda į šį skyrių:
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 agentNuoroda į šį skyrių:
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 itselfNuoroda į šį skyrių:
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 yourselfNuoroda į šį skyrių:
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 agentNuoroda į šį skyrių:
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 toolsNuoroda į šį skyrių:
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 įrankis
marketplace_whoamireadReport this agent's own effective access: surface, account, capability or scope levels, store scope, status, expiry and any spending-mandate head-room.
Įvesties parametrų nėra.
Account
always available2 įrankiai
marketplace_list_storesreadList the stores on the seller's account. Pass the accountId reported by marketplace_whoami.
Parametrai
- accountIdstringbūtinas
marketplace_get_storereadGet the details of one of the seller stores by its store id.
Parametrai
- storeIdstringbūtinas
Catalog knowledge
always available3 įrankiai
marketplace_get_categoriesreadGet the marketplace category tree, to choose a category when creating or editing a product.
Įvesties parametrų nėra.
marketplace_get_category_attributesreadGet the attributes a product in a given category can carry.
Parametrai
- categoryIdstringbūtinas
marketplace_list_brandsreadList the marketplace brands a product can be assigned to.
Įvesties parametrų nėra.
Products — reads
products: read4 įrankiai
marketplace_list_productsreadList the products in a store, newest first, with cursor paging.
Parametrai
- storeIdstringbūtinas
- limitinteger
- cursorstring
marketplace_get_productreadGet one product with its variants by product id.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
marketplace_get_product_statsreadGet the product counts for a store, grouped by lifecycle state.
Parametrai
- storeIdstringbūtinas
marketplace_get_variantreadGet one product variant by variant id.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
Products — writes
products: read_write14 įrankių
marketplace_create_productwriteCreate a product with its options, attributes and variants (including each variant price).
Parametrai
- storeIdstringbūtinas
- titlestringbūtinas
- descriptionstringbūtinas
- categoryIdstringbūtinas
- brandIdstring
- sourcestringbūtinas
- inventoryTrackedbooleanbūtinas
- optionsarraybūtinas
- attributesarraybūtinas
- variantsarraybūtinas
marketplace_update_product_detailswriteRename a product or rewrite its description. Provide exactly one of title or description per call.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- titlestring
- descriptionstring
marketplace_set_product_categorywriteSet a product's category.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- categoryIdstringbūtinas
marketplace_set_product_brandwriteSet a product's brand.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- brandIdstringbūtinas
marketplace_set_product_attributeswriteSet a product's attribute values for its category.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- attributesarraybūtinas
marketplace_add_variantwriteAdd one variant to a product from a combination of option values.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- optionValueIdsarraybūtinas
marketplace_generate_variantswriteGenerate a matrix of variants for a product from option combinations.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- newOptionValuesarraybūtinas
- combinationsarraybūtinas
marketplace_update_variant_detailswriteUpdate a variant's SKU and/or barcodes.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
- skustring
- barcodesarray
marketplace_publish_variantwritePublish a variant so it can qualify to sell.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
marketplace_unpublish_variantwriteUnpublish a variant so it stops qualifying to sell.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
marketplace_enable_variantwriteEnable a variant so it is active.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
marketplace_disable_variantwriteDisable a variant so it is inactive.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
marketplace_archive_variantwriteArchive a variant. Reversible with marketplace_restore_variant.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
marketplace_restore_variantwriteRestore a previously archived variant.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
Stock
stock: read / read_write8 įrankiai
marketplace_list_stock_itemsreadList the stock items (SKU inventory) for a store, with cursor paging.
Parametrai
- storeIdstringbūtinas
- limitinteger
- cursorstring
marketplace_get_inventoryreadGet the on-hand inventory balances for a store.
Parametrai
- storeIdstringbūtinas
marketplace_list_stock_movementsreadList the stock movement ledger for a store, with cursor paging.
Parametrai
- storeIdstringbūtinas
- limitinteger
- cursorstring
marketplace_list_warehousesreadList the warehouses stock is held in for a store.
Parametrai
- storeIdstringbūtinas
marketplace_create_stock_itemwriteCreate a stock item (a tracked SKU with its name).
Parametrai
- storeIdstringbūtinas
- skustringbūtinas
- namestringbūtinas
- externalReferencestring
marketplace_set_stock_balancewriteSet the on-hand balance of a stock item at a warehouse to an absolute quantity.
Parametrai
- storeIdstringbūtinas
- stockItemIdstringbūtinas
- warehouseIdstringbūtinas
- quantityintegerbūtinas
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.
Parametrai
- storeIdstringbūtinas
- warehouseIdstringbūtinas
- reasonCodestringbūtinasVienas iš:
DAMAGE·LOSS·FOUND·CORRECTION·RECOUNT·QUALITY_HOLD·QUALITY_RELEASE - notesstring
- linesarraybūtinas
marketplace_post_stock_adjustmentwritePost a drafted stock adjustment so its quantity changes take effect.
Parametrai
- storeIdstringbūtinas
- adjustmentIdstringbūtinas
Orders & customers
orders: read / read_write10 įrankių
marketplace_list_ordersreadList the orders on a store, newest first, with cursor paging.
Parametrai
- storeIdstringbūtinas
- limitinteger
- cursorstring
marketplace_get_order_countsreadGet the order counts for a store, grouped by status.
Parametrai
- storeIdstringbūtinas
marketplace_get_orderreadGet one order in full by order id.
Parametrai
- storeIdstringbūtinas
- orderIdstringbūtinas
marketplace_get_order_timelinereadGet one order timeline (its lifecycle events) by order id.
Parametrai
- storeIdstringbūtinas
- orderIdstringbūtinas
marketplace_cancel_orderwriteCancel an order as the seller, with an optional reason.
Parametrai
- storeIdstringbūtinas
- orderIdstringbūtinas
- reasonstring
marketplace_advance_shipmentwriteAdvance a shipment to its next fulfilment state.
Parametrai
- storeIdstringbūtinas
- orderIdstringbūtinas
- shipmentIdstringbūtinas
marketplace_list_customersreadList a store customers (its CRM), with cursor paging.
Parametrai
- storeIdstringbūtinas
- limitinteger
- cursorstring
marketplace_get_customerreadGet one customer CRM record by customer id.
Parametrai
- storeIdstringbūtinas
- customerIdstringbūtinas
marketplace_add_customer_notewriteSet the seller-private note on a customer CRM record.
Parametrai
- storeIdstringbūtinas
- customerIdstringbūtinas
- notestringbūtinas
marketplace_tag_customerwriteAdd a tag to a customer CRM record.
Parametrai
- storeIdstringbūtinas
- customerIdstringbūtinas
- labelstringbūtinas
Reviews
orders: read / read_write3 įrankiai
marketplace_list_reviewsreadList the store customer reviews, newest first, with cursor paging.
Parametrai
- storeIdstringbūtinas
- limitinteger
- cursorstring
marketplace_get_review_summaryreadGet the review summary for a store: average rating and rating distribution.
Parametrai
- storeIdstringbūtinas
marketplace_respond_to_reviewwritePost the seller public response to a customer review.
Parametrai
- storeIdstringbūtinas
- reviewIdstringbūtinas
- messagestringbūtinas
AI assist
products: read4 įrankiai
marketplace_identify_productreadIdentify a product from a text query and/or barcodes: category, brand, match candidates, price band.
Parametrai
- querystring
- barcodesarray
marketplace_match_catalog_productsreadFind canonical catalog products matching a grounded identification or intent.
Parametrai
- modestringbūtinas
- groundedobject
- intentobject
- sellerStoreIdstring
- limitinteger
- minConfidencenumber
marketplace_get_catalog_product_detailreadGet the matched canonical catalog product detail by product id.
Parametrai
- productIdstringbūtinas
marketplace_suggest_variantsreadSuggest variant candidates for a matched catalog product in a category.
Parametrai
- productIdstringbūtinas
- categoryIdstringbūtinas
- intentobject
Import & CMS
products: read / read_write6 įrankiai
marketplace_start_importwriteStage a catalog CSV import from an uploaded file; confirm it to apply.
Parametrai
- storeIdstringbūtinas
- uploadIdstringbūtinas
marketplace_get_import_statusreadGet one import status and its row-level errors by import id.
Parametrai
- storeIdstringbūtinas
- importIdstringbūtinas
marketplace_confirm_importwriteCommit a staged catalog import so its rows are applied.
Parametrai
- storeIdstringbūtinas
- importIdstringbūtinas
marketplace_get_cms_connectionreadGet the CMS connection for a store, including its connectionId.
Parametrai
- storeIdstringbūtinas
marketplace_trigger_cms_importwriteTrigger a catalog sync from a connected CMS (WooCommerce / Shopify).
Parametrai
- storeIdstringbūtinas
- connectionIdstringbūtinas
marketplace_get_cms_sync_statusreadGet the CMS sync jobs for a connection: their progress and outcomes.
Parametrai
- storeIdstringbūtinas
- connectionIdstringbūtinas
Pricing
pricing: read_write1 įrankis
marketplace_set_variant_pricewriteSet a variant's price (in cents), within the owner's repricing bound.
Parametrai
- storeIdstringbūtinas
- productIdstringbūtinas
- variantIdstringbūtinas
- priceAmountintegerbūtinas
- priceCurrencystringbūtinas
Media
products: read_write1 įrankis
marketplace_upload_filewriteUpload a product image (JPEG, PNG or WebP, base64) and get an uploadId to attach it to a product.
Parametrai
- fileNamestringbūtinas
- mimeTypestringbūtinas
- contentBase64stringbūtinas
Tool detailNuoroda į šį skyrių:
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 workflowsNuoroda į šį skyrių:
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 photoNuoroda į šį skyrių:
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 systemNuoroda į šį skyrių:
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 outNuoroda į šį skyrių:
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 orderNuoroda į šį skyrių:
marketplace_list_orders— active, completed or cancelledmarketplace_get_order— items, shipments and timelinemarketplace_track_order— payment confirmation status and retry options
Errors and limitsNuoroda į šį skyrių:
| 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 |
EnvironmentsNuoroda į šį skyrių:
| 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. |