Compila múltiples MCP servers y REST APIs en un único endpoint de herramientas optimizado para reducir el uso de contexto y mejorar la precisión del agente.
También conocido como toolc-dev/toolc, @toolc/cli
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.1.1
- Último commit
- 15 sept 2026
- Licencia
- Apache-2.0
¿Qué es toolc MCP?
toolc es un MCP server. Compila múltiples MCP servers y REST APIs en un único endpoint de herramientas optimizado para reducir el uso de contexto y mejorar la precisión del agente.
Resumen generado a partir del README del proyecto
Acerca del MCP server de toolc
toolc actúa como un compilador de optimización para las superficies de herramientas de los agentes, diseñado para evitar la saturación de la ventana de contexto al conectar múltiples MCP servers o REST APIs. En lugar de volcar cada definición de herramienta en el contexto de un modelo, este sistema compila una federación de herramientas en un único endpoint optimizado. Los desarrolladores pueden dirigir el motor hacia MCP servers existentes, especificaciones OpenAPI o incluso páginas de documentación para generar una superficie de herramientas más inteligente.
Los usuarios pueden ejecutar esto localmente a través de un CLI o utilizar el servicio alojado en toolc.dev para obtener endpoints HTTPS gestionados y un explorador de logs. El proceso de compilación incluye la reescritura de descripciones para una mejor comprensión del LLM, la consolidación de herramientas casi duplicadas en herramientas de fachada únicas y la compresión de todo el catálogo mediante meta-tools como search_tools y call_tool. Para realizar las fases de reescritura y consolidación, el sistema requiere una ANTHROPIC_API_KEY. La superficie resultante puede servirse a través de stdio para su uso en clientes como Claude o como una REST API estándar.
Qué puedes hacer con él
- 1Reducir costes de tokensMinimiza el gasto de las tareas de los agentes comprimiendo las definiciones de las herramientas y resumiendo resultados de gran tamaño.
- 2Integrar REST APIsAñade servicios web externos a las capacidades de tu agente utilizando una especificación OpenAPI o documentación.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar toolc MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar toolc MCP en Claude Code
$ claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cliInstalar toolc MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Instalar toolc MCP en VS Code
.vscode/mcp.json
{
"servers": {
"toolc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Instalar toolc MCP en 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 toolc MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Instalar toolc MCP en Codex
$ codex mcp add toolc --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -- npx -y @toolc/cliInstalar toolc MCP en 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 toolc MCP en Gemini CLI
$ gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc npx -- -y @toolc/cliInstalar toolc MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"toolc": {
"command": "npx",
"args": [
"-y",
"@toolc/cli"
],
"env": {
"ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>"
}
}
}
}Configuración
ANTHROPIC_API_KEYSecretoEnables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface.
| Nombre | Descripción | Tipo |
|---|---|---|
| ANTHROPIC_API_KEY | Enables the LLM-assisted compile passes (rewrite, consolidate). Without it, toolc serves a mirror of the original tool surface. | Secreto |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibletoolc-dev/toolc is public and reachablegithub.com/toolc-dev/toolc ↗Aprobado
- El paquete indica este repositorio como su origen@toolc/cli names toolc-dev/toolc as sourcenpmjs.com/package/@toolc/cli ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-09-15github.com/toolc-dev/toolc ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @toolc/cliAprobado
- No hay avisos críticos en el paquete ni en sus dependencias102 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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.
Preguntas sobre toolc MCP
¿Cómo agrego toolc MCP a Claude Code?
Ejecuta claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' toolc -- npx -y @toolc/cli en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego toolc MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Puedo usar mis propias REST APIs con toolc?
Sí, puedes incluir REST APIs proporcionando una especificación OpenAPI o utilizando una especificación redactada a partir de la documentación.
¿toolc admite el despliegue local?
Sí, el motor tiene licencia Apache-2.0 y te permite compilar y servir superficies de herramientas localmente usando el CLI.
¿Cuánto puede reducir toolc los costes?
Los benchmarks muestran que las superficies de herramientas compiladas y consolidadas pueden ser hasta 6.4 veces más baratas que el uso de herramientas sin procesar.