Compila múltiplos MCP servers e REST APIs em um único endpoint de ferramenta otimizado para reduzir o uso de contexto e melhorar a precisão do agente.
Também conhecido como toolc-dev/toolc, @toolc/cli
- Stars
- 0
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- 0.1.1
- Último commit
- 15 de set. de 2026
- Licença
- Apache-2.0
O que é o MCP toolc?
toolc é um MCP server. Compila múltiplos MCP servers e REST APIs em um único endpoint de ferramenta otimizado para reduzir o uso de contexto e melhorar a precisão do agente.
Resumo gerado a partir do README do projeto
Sobre o MCP server de toolc
O toolc atua como um compilador de otimização para superfícies de ferramentas de agentes, projetado para evitar o inchaço da janela de contexto ao conectar múltiplos MCP servers ou REST APIs. Em vez de despejar cada definição de ferramenta no contexto de um modelo, este sistema compila uma federação de ferramentas em um único endpoint simplificado. Desenvolvedores podem apontar o engine para MCP servers existentes, especificações OpenAPI ou até mesmo páginas de documentação para gerar uma superfície de ferramentas mais inteligente.
Os usuários podem executar isso localmente via CLI ou usar o serviço hospedado em toolc.dev para endpoints HTTPS gerenciados e um explorador de logs. O processo de compilação inclui a reescrita de descrições para melhor compreensão do LLM, a consolidação de ferramentas quase duplicadas em ferramentas de fachada únicas e a compressão de todo o catálogo por trás de meta-tools como search_tools e call_tool. Para realizar as etapas de reescrita e consolidação, o sistema requer uma ANTHROPIC_API_KEY. A superfície resultante pode ser servida via stdio para uso em clientes como Claude ou como uma REST API padrão.
O que você pode fazer com ele
- 1Reduzir custos de tokensMinimize os gastos com tarefas de agentes comprimindo definições de ferramentas e resumindo resultados excessivamente grandes.
- 2Integrar REST APIsAdicione serviços web externos às capacidades do seu agente usando uma especificação OpenAPI ou documentação.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP toolc
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP toolc no Claude Code
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cliInstalar o MCP toolc no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Instalar o MCP toolc no VS Code
.vscode/mcp.json
{
"servers": {
"toolc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Instalar o MCP toolc no VS Code CLI
$ code --add-mcp '{"name":"toolc","type":"stdio","command":"npx","args":["-y","@toolc/cli"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>"}}'Instalar o MCP toolc no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Instalar o MCP toolc no Codex
$ codex mcp add toolc --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -- npx -y @toolc/cliInstalar o MCP toolc no Codex config.toml
~/.codex/config.toml
[mcp_servers.toolc] command = "npx" args = ["-y", "@toolc/cli"] [mcp_servers.toolc.env] ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>"
Instalar o MCP toolc no Gemini CLI
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc npx -- -y @toolc/cliInstalar o MCP toolc no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Configuração
ANTHROPIC_API_KEYSecretoEnables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface.
| Nome | Descrição | Tipo |
|---|---|---|
| ANTHROPIC_API_KEY | Enables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface. | Secreto |
Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessíveltoolc-dev/toolc is public and reachablegithub.com/toolc-dev/toolc ↗Passou
- O pacote indica este repositório como sua origem@toolc/cli names toolc-dev/toolc as sourcenpmjs.com/package/@toolc/cli ↗Passou
- Proveniência da build (atestação Sigstore)No build attestation published for this releaseNão verificado
- Licença de código aberto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-09-15github.com/toolc-dev/toolc ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @toolc/cliPassou
- Nenhum aviso crítico no pacote ou em suas dependências102 resolved dependencies checked; no critical advisoryosv.dev ↗Passou
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no GitHubtoolc
The optimizing compiler for agent tool surfaces. Point it at your MCP servers, or just a REST API's OpenAPI spec, or even a docs page, and get back one endpoint that serves a smaller, smarter tool surface: cheaper for every agent that connects, more accurate on every task, with every call logged.
Connecting N MCP servers dumps every tool definition into the model's context, degrades tool selection, and forces improvised multi-hop call chains. toolc compiles the federation instead:
- Rewrite: LLM-optimized descriptions with sibling disambiguation
- Consolidate: families of near-duplicate tools (
search_x/find_x/get_x) merge into single facade tools with deterministic routing - Selection: the whole catalog compresses behind two meta-tools
(
search_tools/call_tool) when you want maximum context savings - Compaction: oversized results are summarized at serve time, preserving identifiers and sourcing details
- Compose: REST APIs join the pool straight from an OpenAPI spec, or from a drafted spec synthesized from their documentation
- Observe: every call logged with arguments and results; recurring errors cluster into recommended fixes
Benchmark
131 tools across 5 live servers, 30 tasks × 3 trials, judged answers (full grid · consolidation run):
| condition | success | cost / completed task | tool-def context |
|---|---|---|---|
| raw (all 131 tools) | 96.7% | $0.2631 | ~24,360 tok |
| compiled + consolidate | 96.7% | $0.0411 (6.4× cheaper) | ~845 tok |
| consolidate, no selection | 100.0% | $0.1335 | ~14,506 tok |
Consolidation dominates both ends of the frontier: the selection surface is the cost lever, consolidation lifts accuracy everywhere. Every pass is a config toggle; pick the tradeoff per deployment.
Quick start
git clone https://github.com/toolc-dev/toolc && cd toolc
pnpm install && pnpm -r test
# describe your federation
cp toolc.config.example.jsonc toolc.config.jsonc
# introspect it
node packages/cli/bin/toolc.mjs -c toolc.config.jsonc inspect
# compile (set ANTHROPIC_API_KEY for the rewrite/consolidate passes)
node packages/cli/bin/toolc.mjs -c toolc.config.jsonc compile
# serve the compiled surface over stdio (add to Claude as an MCP server)
node packages/cli/bin/toolc.mjs -c toolc.config.jsonc serve --mode compiled
A downstream can be an MCP server or a bare REST API:
{
"downstream": [
{ "id": "gh", "transport": { "type": "http", "url": "https://api.githubcopilot.com/mcp/" } },
{ "id": "nws", "transport": { "type": "openapi", "spec": "https://api.weather.gov/openapi.json" } }
]
}
See SELF_HOSTING.md for Docker deployment.
Hosted
toolc.dev runs this same engine as a managed service: compiled HTTPS endpoints, a console with a playground and full-payload log explorer, docs-to-spec drafting, and error-driven fix recommendations.
Layout
packages/core: IR (Capability Graph), frontends (MCP, OpenAPI, docs synthesis), passes, emitpackages/gateway: runtime MCP server (mirror + compiled) with call logging and compactionpackages/cli: thetoolccommandpackages/harness: benchmark runner, grading, reportspackages/shared: config schema, errors
License
The engine (everything in this repository) is Apache-2.0, forever: anyone can compile and serve their own tool surfaces locally with the exact same compilation quality as the hosted product.
Perguntas sobre o MCP toolc
Como adiciono o MCP toolc ao Claude Code?
Execute claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cli no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP toolc ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Posso usar minhas próprias REST APIs com o toolc?
Sim, você pode incluir REST APIs fornecendo uma especificação OpenAPI ou usando uma especificação rascunhada a partir de documentações.
O toolc suporta implantação local?
Sim, o engine possui licença Apache-2.0 e permite que você compile e sirva superfícies de ferramentas localmente usando a CLI.
Quanto o toolc pode reduzir custos?
Benchmarks mostram que superfícies de ferramentas compiladas e consolidadas podem ser até 6,4 vezes mais baratas do que o uso de ferramentas brutas.