TOTVS Protheus
TOTVS Protheus ERP for AI: stock, sales, orders, customers and MRP. Read-only, official API.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (4)
- LOWTool 'protheus_parametros' description lacks action verben protheus_parametros
- LOWTool 'protheus_produtos' description lacks action verben protheus_produtos
- LOWTool 'protheus_estoque' description lacks action verben protheus_estoque
- LOWTool 'connect' description lacks action verben connect
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
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": {
"protheus-mcp": {
"url": "https://api.mcp.ai/p_protheus"
}
}
}Puntos de conexión remotos
https://api.mcp.ai/p_protheusstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (32)
🟢protheus_list_accounts(account)
Lista as instalações Protheus conectadas a este install, com id e label (host/usuário).
Esquema de entrada
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_diagnostico(termo, limit, account)
Descobre quais APIs REST esta instalação Protheus realmente responde. Sonda cada API do catálogo oficial com uma consulta mínima e classifica em disponivel, ausente, sem_permissao ou erro. Rode isto primeiro numa conta nova: a TOTVS publica 125 APIs para a linha Protheus, mas cada instalação expõe um subconjunto, conforme a versão da LIB, os módulos licenciados e as customizações.
Esquema de entrada
{
"type": "object",
"properties": {
"termo": {
"type": "string"
},
"limit": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_catalogo(termo, segmento, limit, account)
Consulta o catálogo das 125 APIs REST oficiais da linha Protheus (id, título, módulo e rotas de leitura), extraído da documentação pública da TOTVS. Serve para descobrir qual rota passar em protheus_api. É documentação, não disponibilidade: para saber o que esta instalação responde, use protheus_diagnostico.
Esquema de entrada
{
"type": "object",
"properties": {
"termo": {
"type": "string"
},
"segmento": {
"type": "string"
},
"limit": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_api(path, page, page_size, order, fields, ...)
Faz um GET em qualquer rota REST da instalação Protheus conectada. Use para as APIs oficiais que não têm tool dedicada (descubra a rota com protheus_catalogo) e para os endpoints MVC customizados que a empresa criou. Somente leitura.
Esquema de entrada
{
"type": "object",
"properties": {
"path": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
}
},
"required": [
"path"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_filiais(page, page_size, order, fields, filter, ...)
Lista as empresas e filiais do grupo (API TSIBranches). É o ponto de partida prático: os códigos de empresa e filial daqui alimentam o header tenantId da conexão e os filtros branchId das demais tools.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_modulos(page, page_size, order, fields, filter, ...)
Lista os módulos do sistema Protheus nesta instalação. Indica o que está ativo e ajuda a explicar por que uma API responde ou não.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_parametros(page, page_size, order, fields, filter, ...)
Consulta os parâmetros de sistema do Protheus.
Esquema de entrada
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_usuarios(id, page, page_size, order, fields, ...)
Lista os usuários do Protheus, ou consulta um usuário por id. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_clientes_fornecedores(tipo, id, page, page_size, order, ...)
Consulta o cadastro de clientes e fornecedores (API CustomerVendor). Sem filtro traz a coleção inteira; `tipo` separa a entidade e, junto com `id`, traz um registro específico. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"tipo": {
"type": "string"
},
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_contatos(id, page, page_size, order, fields, ...)
Lista os contatos do CRM, ou consulta um contato por id. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_vendedores(id, page, page_size, order, fields, ...)
Lista os vendedores cadastrados, ou consulta um vendedor pelo código. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_oportunidades(id, page, page_size, order, fields, ...)
Lista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_propostas_comerciais(oportunidade_id, id, page, page_size, order, ...)
Lista as propostas comerciais de uma oportunidade, ou consulta uma proposta específica. No Protheus a proposta vive dentro da oportunidade, então `oportunidade_id` é obrigatório. Bulk support: accepts oportunidade_ids, ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"oportunidade_id": {
"type": "string"
},
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"oportunidade_ids": {
"type": "array",
"items": {
"type": "string"
}
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"oportunidade_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_tabela_precos(codigo, itens, page, page_size, order, ...)
Consulta as tabelas de preço. Sem argumentos lista os cabeçalhos; com `codigo` traz uma tabela; com `codigo` e `itens` traz os itens e preços dela.
Esquema de entrada
{
"type": "object",
"properties": {
"codigo": {
"type": "string"
},
"itens": {
"type": "boolean"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_condicoes_pagamento(id, page, page_size, order, fields, ...)
Lista as condições de pagamento cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_limite_credito(cliente_id, page, page_size, order, fields, ...)
Consulta o limite de crédito dos clientes. Com `cliente_id` traz o limite de um cliente específico. Bulk support: accepts cliente_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"cliente_id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"cliente_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_comissoes(id, page, page_size, order, fields, ...)
Consulta as comissões de venda, ou uma comissão pelo id interno. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_transportadoras(id, page, page_size, order, fields, ...)
Lista as transportadoras cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_centros_custo(id, page, page_size, order, fields, ...)
Lista os centros de custo da contabilidade, ou consulta um pelo id interno. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_produtos(fonte, page, page_size, order, fields, ...)
Consulta o cadastro de produtos. O Protheus expõe produto por módulo, então escolha a fonte: varejo (API de produtos do varejo) ou mrp (produto do planejamento de manufatura). São cadastros diferentes, não duas visões do mesmo.
Esquema de entrada
{
"type": "object",
"properties": {
"fonte": {
"type": "string",
"enum": [
"varejo",
"mrp"
]
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_estoque(fonte, page, page_size, order, fields, ...)
Consulta o saldo em estoque. Escolha a fonte: varejo (saldo em estoque do varejo) ou mrp (estoque do MRP, com armazém, lote e saldos bloqueado, consignado e em controle de qualidade). São módulos distintos e podem divergir.
Esquema de entrada
{
"type": "object",
"properties": {
"fonte": {
"type": "string",
"enum": [
"varejo",
"mrp"
]
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_vendas_varejo(id, page, page_size, order, fields, ...)
Consulta as vendas do varejo, ou uma venda pelo id interno. Exige o módulo de varejo publicado nesta instalação. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_pedidos_varejo(id, page, page_size, order, fields, ...)
Lista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido. Bulk support: accepts ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_notas_totais(tipo, canceladas, page, page_size, order, ...)
Consulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.
Esquema de entrada
{
"type": "object",
"properties": {
"tipo": {
"type": "string",
"enum": [
"saida",
"entrada"
]
},
"canceladas": {
"type": "boolean"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_ordens_producao(branch_id, codigo, page, page_size, order, ...)
Consulta as ordens de produção do MRP. Aceita filtros da própria API em `params` (branchId, product, warehouse, deliveryDate, startDate). Com `branch_id` e `codigo` traz uma ordem específica. Bulk support: accepts branch_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"branch_id": {
"type": "string"
},
"codigo": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"branch_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢protheus_compras_mrp(tipo, branch_id, codigo, page, page_size, ...)
Consulta os pedidos de compra ou as solicitações de compra do MRP. Aceita filtros da API em `params` (branchId, product, deliveryDate, warehouse). Com `branch_id` e `codigo` traz um registro específico. Bulk support: accepts branch_ids for batched execution.
Esquema de entrada
{
"type": "object",
"properties": {
"tipo": {
"type": "string",
"enum": [
"pedido",
"solicitacao"
]
},
"branch_id": {
"type": "string"
},
"codigo": {
"type": "string"
},
"page": {
"type": "number"
},
"page_size": {
"type": "number"
},
"order": {
"type": "string"
},
"fields": {
"type": "string"
},
"filter": {
"type": "string"
},
"expand": {
"type": "string"
},
"sql_filter": {
"type": "string"
},
"params": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
}
]
}
},
"account": {
"type": "string"
},
"branch_ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"$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
Evidencia