# Mercos — MCP server on mcp.ai
> Sales force and rep ERP on Mercos via the official API. List orders, customers, products, price tables, payment terms, carriers, sellers and commissions, and create or update customers, products, orders and stock in natural language. Auth via a Company Token, generated in the Mercos account under My Account, System, Integration.

By: mcp.ai · official
Page: https://mcp.ai/mercos

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_mercos?ms=1782769140000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/mercos/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/mercos/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/mercos/skill.md
Postman collection (v2.1): https://mcp.ai/mercos/postman.json

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

## Example prompts
- "List orders changed since yesterday"
- "Create a new customer from these details"
- "List commissions for the seller with colaborador_id 123"

## Links
Docs: https://mcp.ai/docs/mcps/mercos
Website: https://mcp.ai/mcps/mercos