MCP MeasureMCP Measure

índice observado

Mercos

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

¿Debería usar esto?

Calidad y seguridad

B
Calidad de la descripción
85%
Integridad del esquema
68%
Calidad de los nombres
80%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (7)

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

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~3,653Tokens (definiciones de herramientas)
~672 BTamaño de respuesta típico
Impacto significativo en la atención (2.85% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

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

Puntos de conexión remotos

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

Qué puede hacer

Inventario de herramientas

Herramientas (25)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢mercos_list_accounts(account)

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

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.)

Esquema de entrada

{
  "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).

Esquema de entrada

{
  "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).

Esquema de entrada

{
  "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).

Esquema de entrada

{
  "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).

Esquema de entrada

{
  "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).

Esquema de entrada

{
  "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`.

Esquema de entrada

{
  "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).

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

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

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada25 herramientas
verificadoversión no registrada25 herramientas