MCP server

Mercos

io.github.mcp-dir/mercos-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Sales force and rep ERP on Mercos via the official API. List orders, customers, products, price tabl

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

25

Token cost

About 3,190 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http mercos-mcp https://api.mcp.ai/p_mercos

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.mercos-mcp]
url = "https://api.mcp.ai/p_mercos"

Gemini CLI

{"mcpServers":{"mercos-mcp":{"httpUrl":"https://api.mcp.ai/p_mercos"}}}

Cursor

{"mcpServers":{"mercos-mcp":{"url":"https://api.mcp.ai/p_mercos"}}}

VS Code

{"servers":{"mercos-mcp":{"type":"http","url":"https://api.mcp.ai/p_mercos"}}}

Antigravity

agy mcp add mercos-mcp https://api.mcp.ai/p_mercos

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"mercos-mcp","server_url":"https://api.mcp.ai/p_mercos","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"mercos-mcp","server_url":"https://api.mcp.ai/p_mercos"}

Tools

• mercos_ajustar_estoque ~92 tokens
  Ajusta o estoque de produtos em lote (POST /v1/ajustar_estoque_em_lote). `data` = array de ajustes.
• mercos_create_cliente ~86 tokens
  Inclui cliente(s) (POST /v1/clientes). `data` = objeto ou array de clientes.
• mercos_create_pedido ~89 tokens
  Inclui um pedido (POST /v2/pedidos). `data` com cliente, itens, condição de pagamento etc.
• mercos_create_produto ~86 tokens
  Inclui produto(s) (POST /v1/produtos). `data` = objeto ou array de produtos.
• mercos_create_tabela_preco ~89 tokens
  Inclui uma tabela de preço (POST /v1/tabelas_preco). `data` com os campos da tabela.
• mercos_list_accounts ~74 tokens
  Lista as empresas (CompanyToken) Mercos conectadas a este install, com id e label.
• mercos_list_categorias ~83 tokens
  Lista categorias de produtos (GET /v1/categorias).
• mercos_list_clientes ~89 tokens
  Lista clientes (GET /v1/clientes). Use `alterado_apos` pra incremental.
• mercos_list_comissoes ~94 tokens
  Lista comissões (GET /v1/comissoes). Filtre por colaborador_id ou pedido_id via `filters`.
• mercos_list_condicoes_pagamento ~88 tokens
  Lista condições de pagamento (GET /v1/condicoes_pagamento).
• mercos_list_pedidos ~94 tokens
  Lista pedidos (GET /v2/pedidos). Use `alterado_apos` pra incremental. (Pedidos vivem na v2.)
• mercos_list_produtos ~92 tokens
  Lista produtos cadastrados (GET /v1/produtos). Use `alterado_apos` pra incremental.
• mercos_list_tabelas_preco ~83 tokens
  Lista tabelas de preço (GET /v1/tabelas_preco).
• mercos_list_titulos ~81 tokens
  Lista títulos financeiros (GET /v1/titulos).
• mercos_list_transportadoras ~84 tokens
  Lista transportadoras (GET /v1/transportadoras).
• mercos_list_usuarios ~81 tokens
  Lista vendedores/usuários (GET /v1/usuarios).
• mercos_update_cliente ~141 tokens
  Altera um cliente (PUT /v1/clientes/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.
• mercos_update_pedido ~140 tokens
  Altera um pedido (PUT /v2/pedidos/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.
• mercos_update_produto ~141 tokens
  Altera um produto (PUT /v1/produtos/{id}). `id` + `data` com os campos a alterar. Bulk support: accepts ids for batched execution.

Browse

• GitHub tools
• GitHub and code hosting

Related MCP servers

• Cin7 Core MCP by usefulapi
  Read Cin7 Core products, stock by location, sales, purchases, customers, suppliers and transfers.
• Laudus MCP by usefulapi
  Read Laudus ERP customers, sales, purchases, stock and accounting reports; create customers.
• Unleashed Software MCP by usefulapi
  Check products, stock on hand, customers, orders, invoices and quotes, and create records.
• KiotViet MCP by usefulapi
  Read KiotViet products, customers, invoices, orders and stock; create customers and orders.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• Lightspeed Retail (X-Series) MCP by usefulapi
  Read Lightspeed X-Series products, stock, sales, customers, stock orders; one-call sales reports.
• Bind ERP MCP by usefulapi
  Read Bind ERP clients, products, inventory, invoices, orders; create prospects, clients, orders.
• vintrace MCP by usefulapi
  Read vintrace vessels, batches, work orders, lab results, stock; assign work orders, add notes.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.mcp-dir/mercos-mcp.svg)](https://aptlynx.net/servers/io.github.mcp-dir/mercos-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents