Mercos MCP server

• authenticateFree

  MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

• connectFree

  Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

• marketplaceFree

  The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

• mercos_ajustar_estoqueFree

  Ajusta o estoque de produtos em lote (POST /v1/ajustar_estoque_em_lote). `data` = array de ajustes.

• mercos_create_clientewrite actionFree

  Inclui cliente(s) (POST /v1/clientes). `data` = objeto ou array de clientes.

• mercos_create_pedidowrite actionFree

  Inclui um pedido (POST /v2/pedidos). `data` com cliente, itens, condição de pagamento etc.

• mercos_create_produtowrite actionFree

  Inclui produto(s) (POST /v1/produtos). `data` = objeto ou array de produtos.

• mercos_create_tabela_precowrite actionFree

  Inclui uma tabela de preço (POST /v1/tabelas_preco). `data` com os campos da tabela.

• mercos_list_accountsFree

  Lista as empresas (CompanyToken) Mercos conectadas a este install, com id e label.

• mercos_list_categoriasFree

  Lista categorias de produtos (GET /v1/categorias).

• mercos_list_clientesFree

  Lista clientes (GET /v1/clientes). Use `alterado_apos` pra incremental.

• mercos_list_comissoesFree

  Lista comissões (GET /v1/comissoes). Filtre por colaborador_id ou pedido_id via `filters`.

• mercos_list_condicoes_pagamentoFree

  Lista condições de pagamento (GET /v1/condicoes_pagamento).

• mercos_list_pedidosFree

  Lista pedidos (GET /v2/pedidos). Use `alterado_apos` pra incremental. (Pedidos vivem na v2.)

• mercos_list_produtosFree

  Lista produtos cadastrados (GET /v1/produtos). Use `alterado_apos` pra incremental.

• mercos_list_tabelas_precoFree

  Lista tabelas de preço (GET /v1/tabelas_preco).

• mercos_list_titulosFree

  Lista títulos financeiros (GET /v1/titulos).

• mercos_list_transportadorasFree

  Lista transportadoras (GET /v1/transportadoras).

• mercos_list_usuariosFree

  Lista vendedores/usuários (GET /v1/usuarios).

• mercos_update_clientewrite actionFree

  Altera um cliente (PUT /v1/clientes/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.

• mercos_update_pedidowrite actionFree

  Altera um pedido (PUT /v2/pedidos/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.

• mercos_update_produtowrite actionFree

  Altera um produto (PUT /v1/produtos/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.

• report_bugFree

  Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

• show_versionFree

  Show the current MCP platform and adapter versions.

• toolkit_infoFree

  Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

• –Code scanremote-only server, no package to scann/a
• Live reliabilityremote reachable in 594ms20/20
• Tool poisoning25 tool descriptions checked15/15
• Auth qualityopen endpoint exposes 7 write-action tools with no auth3/15
• Maintenancelast push 63 days ago12/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Safety score

79/100

higher than 68% of 2,174 E-commerce servers

Tools

25

the typical E-commerce server has 6

Tools that change things

28%

typical: 0%. Fewer write tools means less an agent can break

Uptime

100%

of our recent checks; the typical remote E-commerce server answers 100%

Response time

121 ms

faster than 82% of 1,527 E-commerce servers

Mercos: common questions

Is Mercos MCP server safe?

Mostly: it is graded B (79/100). Read the Mercos safety report

How do I install Mercos?

It runs remotely at api.mcp.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.

Does Mercos need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Mercos maintained?

The last commit was 66 days ago (2026-08-30). The latest release is v0.1.0.

Is Mercos up?

100% of our last 28 checks got an answer. We check remote servers about four times a day.

What can I use instead of Mercos?

Servers from other publishers that do the same job: Omie MCP server, Shopware MCP server and Stripe MCP server.

How does Mercos compare with other E-commerce MCP servers?

safety score 79/100 (higher than 68% of 2,174 E-commerce servers); tools 25 (the typical E-commerce server has 6); tools that change things 28% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.