io.github.mcp-dir/mercos-mcp

Mercos

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

0.1.0
Version
remote
Transport
25
Tools

Security review

Review passed

Reviewed 21h ago.

  • tools: 25 tools scanned
  • metadata: scanned

No findings.

Tools (25)

  • mercos_list_accounts

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

  • mercos_list_produtos

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

  • mercos_list_clientes

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

  • mercos_list_pedidos

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

  • mercos_list_tabelas_preco

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

  • mercos_list_categorias

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

  • mercos_list_condicoes_pagamento

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

  • mercos_list_transportadoras

    Lista transportadoras (GET /v1/transportadoras).

  • mercos_list_usuarios

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

  • mercos_list_comissoes

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

  • mercos_list_titulos

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

  • mercos_create_cliente

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

  • mercos_update_cliente

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

  • mercos_create_produto

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

  • mercos_update_produto

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

  • mercos_create_pedido

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

  • mercos_update_pedido

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

  • mercos_ajustar_estoque

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

  • mercos_create_tabela_preco

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

  • show_version

    Show the current MCP platform and adapter versions.

  • report_bug

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

  • connect

    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.

  • toolkit_info

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

  • marketplace

    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;

  • authenticate

    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.