MCP MeasureMCP Measure

index observed

Mercos

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

Should I use this

Quality & Safety

B
Description quality
85%
Schema completeness
68%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (7)

  • LOWTool 'mercos_create_cliente' description lacks action verbin mercos_create_cliente
  • LOWTool 'mercos_create_produto' description lacks action verbin mercos_create_produto
  • LOWTool 'mercos_create_pedido' description lacks action verbin mercos_create_pedido
  • LOWTool 'mercos_ajustar_estoque' description lacks action verbin mercos_ajustar_estoque
  • LOWTool 'mercos_create_tabela_preco' description lacks action verbin mercos_create_tabela_preco
  • LOWTool 'connect' description lacks action verbin connect
  • LOWTool 'mercos_list_condicoes_pagamento' name length outside 3-30 rangein mercos_list_condicoes_pagamento

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,653Tokens (tool definitions)
~672 BTypical response size
Significant attention impact (2.85% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

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

Remote endpoints

https://api.mcp.ai/p_mercosstreamable-http

What it can do

Tool inventory

Tools (25)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢mercos_list_accounts(account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_produtos(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_clientes(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_pedidos(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_tabelas_preco(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_categorias(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_condicoes_pagamento(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_transportadoras(alterado_apos, filters, account)

Lista transportadoras (GET /v1/transportadoras).

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_usuarios(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_comissoes(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢mercos_list_titulos(alterado_apos, filters, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "alterado_apos": {
      "type": "string"
    },
    "filters": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡mercos_create_cliente(data, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "required": [
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡mercos_update_cliente(id, data, account, ids)

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

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  },
  "required": [
    "id",
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡mercos_create_produto(data, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "required": [
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡mercos_update_produto(id, data, account, ids)

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

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  },
  "required": [
    "id",
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡mercos_create_pedido(data, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "required": [
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡mercos_update_pedido(id, data, account, ids)

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

Input Schema

{
  "type": "object",
  "properties": {
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  },
  "required": [
    "id",
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
⚪mercos_ajustar_estoque(data, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "required": [
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡mercos_create_tabela_preco(data, account)

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

Input Schema

{
  "type": "object",
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  },
  "required": [
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢show_version

Show the current MCP platform and adapter versions.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡report_bug(message, context, conversation)

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

Input Schema

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    },
    "context": {
      "default": "",
      "type": "string"
    },
    "conversation": {
      "default": "[]",
      "type": "string"
    }
  },
  "required": [
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟢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.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡marketplace(action, query, mcp_id, limit, tier_slug, ...)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "action": {
      "default": "search",
      "type": "string",
      "enum": [
        "search",
        "describe",
        "install",
        "uninstall",
        "subscribe",
        "cancel",
        "resume",
        "report_bug",
        "request_mcp",
        "list_tools",
        "invoke",
        "search_prompts",
        "get_prompt",
        "publish_prompt"
      ]
    },
    "query": {
      "default": "",
      "type": "string"
    },
    "mcp_id": {
      "default": "",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "type": "number"
    },
    "tier_slug": {
      "default": "",
      "type": "string"
    },
    "immediate": {
      "default": false,
      "type": "boolean"
    },
    "cancel_reason": {
      "type": "string",
      "enum": [
        "too_expensive",
        "missing_features",
        "switched_service",
        "unused",
        "customer_service",
        "too_complex",
        "low_quality",
        "other"
      ]
    },
    "cancel_comment": {
      "default": "",
      "type": "string"
    },
    "message": {
      "default": "",
      "type": "string"
    },
    "report_context": {
      "default": "",
      "type": "string"
    },
    "conversation": {
      "default": "[]",
      "type": "string"
    },
    "request_name": {
      "default": "",
      "type": "string"
    },
    "request_details": {
      "default": "",
      "type": "string"
    },
    "tool_id": {
      "default": "",
      "type": "string"
    },
    "arguments": {
      "default": "{}",
      "type": "string"
    },
    "prompt_slug": {
      "default": "",
      "type": "string"
    },
    "prompt_vars": {
      "default": "{}",
      "type": "string"
    },
    "prompt_category": {
      "default": "",
      "type": "string"
    },
    "prompt_tool": {
      "default": "",
      "type": "string"
    },
    "prompt_title": {
      "default": "",
      "type": "string"
    },
    "prompt_description": {
      "default": "",
      "type": "string"
    },
    "prompt_body": {
      "default": "",
      "type": "string"
    },
    "prompt_targets": {
      "default": [],
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "claude",
          "chatgpt",
          "cursor",
          "lovable"
        ]
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}
🟡authenticate(token)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded25 tools
verifiedversion not recorded25 tools
verifiedversion not recorded25 tools
verifiedversion not recorded25 tools
verifiedversion not recorded25 tools
verifiedversion not recorded25 tools