Koskamo

mcp-dir TOTVS Protheus MCP

A community MCP server that connects to a company's own TOTVS Protheus ERP installation via the official REST API. It provides read-only access to business data including branches, customers, vendors, products, stock, price lists, sales, orders, invoice totals, production orders, and MRP purchasing. It works with any MCP client over HTTP.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

mcp-dir TOTVS Protheus MCP logo, by mcp-dirCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by mcp-dir
MCP endpoint (Streamable HTTP)
https://api.mcp.ai/p_protheus
Vendor documentation

What its tools do

32 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (29)

Can change data (3)

32 of 32 have a description · 32 of 32 declare behavior hints · 0 of 29 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Discover which REST APIs the specific Protheus installation supports
  • List company branches and their company codes
  • Check today's stock balance by product
  • Show price list items and customer credit limits

Source and maintenance

Community listingRegistry 0.1.0
mcp-registry: io.github.mcp-dir/protheus-mcp@0.1.0Source repository
Maintenance checked

Protocol and capabilities

Server
mcp-ai 0.9.410
MCP protocol negotiated in check
2025-11-25
Tools
32 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

MCP.AI platform v0.9.410 | Adapters: protheus vunknown. When the user asks about the version (e.g. "qual a versão", "which version"), call the show_version tool. NEW MCPs/tools/integrations (capabilities not already in this toolkit) come from the official mcp.ai catalog: the `marketplace` tool (action=search) finds and runs them. You are not authenticated yet. Call the authenticate tool first — it will give the user a browser link to log in and copy a token. No other tools will work until authenticated.

Tools

32 advertised

protheus_list_accounts
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista as instalações Protheus conectadas a este install, com id e label (host/usuário).

protheus_list_accounts input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    }
  }
}
protheus_list_accounts annotations
{
  "title": "protheus_list_accounts",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_diagnostico
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_diagnostico input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number"
    },
    "termo": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  }
}
protheus_diagnostico annotations
{
  "title": "protheus_diagnostico",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_catalogo
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_catalogo input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number"
    },
    "termo": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "segmento": {
      "type": "string"
    }
  }
}
protheus_catalogo annotations
{
  "title": "protheus_catalogo",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_api
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_api input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "path"
  ],
  "properties": {
    "page": {
      "type": "number"
    },
    "path": {
      "type": "string"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_api annotations
{
  "title": "protheus_api",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_filiais
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_filiais input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_filiais annotations
{
  "title": "protheus_filiais",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_modulos
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_modulos input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_modulos annotations
{
  "title": "protheus_modulos",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_parametros
Advertised by the server during the last successful anonymous check.
Advertised read-only

Consulta os parâmetros de sistema do Protheus.

protheus_parametros input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_parametros annotations
{
  "title": "protheus_parametros",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_usuarios
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista os usuários do Protheus, ou consulta um usuário por id. Bulk support: accepts ids for batched execution.

protheus_usuarios input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_usuarios annotations
{
  "title": "protheus_usuarios",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_clientes_fornecedores
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_clientes_fornecedores input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "tipo": {
      "type": "string"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_clientes_fornecedores annotations
{
  "title": "protheus_clientes_fornecedores",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_contatos
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista os contatos do CRM, ou consulta um contato por id. Bulk support: accepts ids for batched execution.

protheus_contatos input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_contatos annotations
{
  "title": "protheus_contatos",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_vendedores
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista os vendedores cadastrados, ou consulta um vendedor pelo código. Bulk support: accepts ids for batched execution.

protheus_vendedores input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_vendedores annotations
{
  "title": "protheus_vendedores",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_oportunidades
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista as oportunidades comerciais do CRM, ou consulta uma oportunidade pelo id interno. Bulk support: accepts ids for batched execution.

protheus_oportunidades input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_oportunidades annotations
{
  "title": "protheus_oportunidades",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_propostas_comerciais
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_propostas_comerciais input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "oportunidade_id"
  ],
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    },
    "oportunidade_id": {
      "type": "string"
    },
    "oportunidade_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
protheus_propostas_comerciais annotations
{
  "title": "protheus_propostas_comerciais",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_tabela_precos
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_tabela_precos input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "itens": {
      "type": "boolean"
    },
    "order": {
      "type": "string"
    },
    "codigo": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_tabela_precos annotations
{
  "title": "protheus_tabela_precos",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_condicoes_pagamento
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista as condições de pagamento cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.

protheus_condicoes_pagamento input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_condicoes_pagamento annotations
{
  "title": "protheus_condicoes_pagamento",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_limite_credito
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_limite_credito input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "cliente_id": {
      "type": "string"
    },
    "sql_filter": {
      "type": "string"
    },
    "cliente_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
protheus_limite_credito annotations
{
  "title": "protheus_limite_credito",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_comissoes
Advertised by the server during the last successful anonymous check.
Advertised read-only

Consulta as comissões de venda, ou uma comissão pelo id interno. Bulk support: accepts ids for batched execution.

protheus_comissoes input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_comissoes annotations
{
  "title": "protheus_comissoes",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_transportadoras
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista as transportadoras cadastradas, ou consulta uma pelo id interno. Bulk support: accepts ids for batched execution.

protheus_transportadoras input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_transportadoras annotations
{
  "title": "protheus_transportadoras",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_centros_custo
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista os centros de custo da contabilidade, ou consulta um pelo id interno. Bulk support: accepts ids for batched execution.

protheus_centros_custo input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_centros_custo annotations
{
  "title": "protheus_centros_custo",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_produtos
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_produtos input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "fonte": {
      "enum": [
        "varejo",
        "mrp"
      ],
      "type": "string"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_produtos annotations
{
  "title": "protheus_produtos",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_estoque
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_estoque input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "fonte": {
      "enum": [
        "varejo",
        "mrp"
      ],
      "type": "string"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_estoque annotations
{
  "title": "protheus_estoque",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_vendas_varejo
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_vendas_varejo input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_vendas_varejo annotations
{
  "title": "protheus_vendas_varejo",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_pedidos_varejo
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lista os pedidos de venda do varejo. Com `id`, retorna os itens daquele pedido. Bulk support: accepts ids for batched execution.

protheus_pedidos_varejo input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "id": {
      "type": "string"
    },
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_pedidos_varejo annotations
{
  "title": "protheus_pedidos_varejo",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_notas_totais
Advertised by the server during the last successful anonymous check.
Advertised read-only

Consulta os totais de notas fiscais de saída ou de entrada do varejo, incluindo a visão de notas canceladas.

protheus_notas_totais input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "tipo": {
      "enum": [
        "saida",
        "entrada"
      ],
      "type": "string"
    },
    "order": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "canceladas": {
      "type": "boolean"
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_notas_totais annotations
{
  "title": "protheus_notas_totais",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_ordens_producao
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_ordens_producao input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "order": {
      "type": "string"
    },
    "codigo": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "branch_id": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "branch_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_ordens_producao annotations
{
  "title": "protheus_ordens_producao",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
protheus_compras_mrp
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

protheus_compras_mrp input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "tipo": {
      "enum": [
        "pedido",
        "solicitacao"
      ],
      "type": "string"
    },
    "order": {
      "type": "string"
    },
    "codigo": {
      "type": "string"
    },
    "expand": {
      "type": "string"
    },
    "fields": {
      "type": "string"
    },
    "filter": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          },
          {
            "type": "boolean"
          }
        ]
      }
    },
    "account": {
      "type": "string"
    },
    "branch_id": {
      "type": "string"
    },
    "page_size": {
      "type": "number"
    },
    "branch_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "sql_filter": {
      "type": "string"
    }
  }
}
protheus_compras_mrp annotations
{
  "title": "protheus_compras_mrp",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
show_version
Advertised by the server during the last successful anonymous check.
Advertised read-only

Show the current MCP platform and adapter versions.

show_version input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
show_version annotations
{
  "title": "Show Version",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
report_bug
Advertised by the server during the last successful anonymous check.

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

report_bug input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "message"
  ],
  "properties": {
    "context": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    }
  }
}
report_bug annotations
{
  "title": "Report Bug",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
connect
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

connect input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
connect annotations
{
  "title": "Connection Status",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
toolkit_info
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

toolkit_info input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}
toolkit_info annotations
{
  "title": "Toolkit Info",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
marketplace
Advertised by the server during the last successful anonymous check.
Open-world

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.

marketplace input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number",
      "default": 10
    },
    "query": {
      "type": "string",
      "default": ""
    },
    "action": {
      "enum": [
        "search",
        "describe",
        "install",
        "uninstall",
        "subscribe",
        "cancel",
        "resume",
        "report_bug",
        "request_mcp",
        "list_tools",
        "invoke",
        "search_prompts",
        "get_prompt",
        "publish_prompt"
      ],
      "type": "string",
      "default": "search"
    },
    "mcp_id": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string",
      "default": ""
    },
    "tool_id": {
      "type": "string",
      "default": ""
    },
    "arguments": {
      "type": "string",
      "default": "{}"
    },
    "immediate": {
      "type": "boolean",
      "default": false
    },
    "tier_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_body": {
      "type": "string",
      "default": ""
    },
    "prompt_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_tool": {
      "type": "string",
      "default": ""
    },
    "prompt_vars": {
      "type": "string",
      "default": "{}"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    },
    "prompt_title": {
      "type": "string",
      "default": ""
    },
    "request_name": {
      "type": "string",
      "default": ""
    },
    "cancel_reason": {
      "enum": [
        "too_expensive",
        "missing_features",
        "switched_service",
        "unused",
        "customer_service",
        "too_complex",
        "low_quality",
        "other"
      ],
      "type": "string"
    },
    "cancel_comment": {
      "type": "string",
      "default": ""
    },
    "prompt_targets": {
      "type": "array",
      "items": {
        "enum": [
          "claude",
          "chatgpt",
          "cursor",
          "lovable"
        ],
        "type": "string"
      },
      "default": []
    },
    "report_context": {
      "type": "string",
      "default": ""
    },
    "prompt_category": {
      "type": "string",
      "default": ""
    },
    "request_details": {
      "type": "string",
      "default": ""
    },
    "prompt_description": {
      "type": "string",
      "default": ""
    }
  }
}
marketplace annotations
{
  "title": "Marketplace",
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
authenticate
Advertised by the server during the last successful anonymous check.

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.

authenticate input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "token": {
      "type": "string"
    }
  }
}
authenticate annotations
{
  "title": "Authenticate",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
548 ms
95th percentile latency
548 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 548 ms · metadata changed · 32 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http totvs-protheus-mcp https://api.mcp.ai/p_protheus

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add totvs-protheus-mcp --url https://api.mcp.ai/p_protheus

Cursor

Merge this server into .cursor/mcp.json in your project, then enable totvs-protheus-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "totvs-protheus-mcp": {
      "url": "https://api.mcp.ai/p_protheus"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "totvs-protheus-mcp": {
      "type": "streamableHttp",
      "url": "https://api.mcp.ai/p_protheus",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start totvs-protheus-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "totvs-protheus-mcp": {
      "type": "http",
      "url": "https://api.mcp.ai/p_protheus"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http totvs-protheus-mcp https://api.mcp.ai/p_protheus

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.mcp.ai/p_protheus

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "totvs-protheus-mcp": {
      "serverUrl": "https://api.mcp.ai/p_protheus"
    }
  }
}

Let your agent find its tools

Find servers like mcp-dir TOTVS Protheus MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 158