# Toolc

> Toolc is an open-source MCP server for ai models and llm tooling. Compiler that merges many MCP servers and REST APIs into one lean tool endpoint. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://toolc.dev
- **Repository:** https://github.com/toolc-dev/toolc
- **MCP Registry name:** dev.toolc/toolc
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-17

## About

Connecting several MCP servers to one agent floods the model's context with tool definitions and makes it worse at picking the right one. Toolc attacks that by treating the whole set of downstream servers as input to a compiler: you point it at MCP servers, an OpenAPI spec or even a documentation page, and it serves a single reshaped tool surface in return.

The passes are individually switchable. They rewrite tool descriptions so sibling tools are told apart, fold near-duplicate tools such as search, find and get variants into facade tools with deterministic routing, and can hide the catalogue behind two meta-tools, search_tools and call_tool, for maximum context savings. At serve time oversized results are summarised while keeping identifiers, and every call is logged with its arguments and results.

The README reports a benchmark of 131 tools across five live servers where the compiled setup kept 96.7% success at about 6.4 times lower cost per completed task. The LLM-assisted passes need an Anthropic API key; without one the server mirrors the original tool surface. A hosted version of the same engine also exists.

## Features

- **Description rewriting:** Rewrites tool descriptions for agents and disambiguates similar sibling tools.
- **Tool consolidation:** Merges families of near-duplicate tools into single facade tools with deterministic routing.
- **Search-based selection:** Compresses the catalogue behind search_tools and call_tool to save context.
- **Result compaction:** Summarises oversized results at serve time while keeping identifiers and sources.
- **REST composition:** Adds REST APIs from an OpenAPI spec or a spec drafted from documentation.
- **Call logging:** Logs every call with arguments and results and clusters recurring errors into suggested fixes.

## Good for

- Combine a dozen MCP servers behind one endpoint for an agent
- Cut tool-definition token cost for a production agent
- Expose a REST API with an OpenAPI spec as MCP tools
- Audit what an agent actually called and why it failed

## Install

### Claude Code (Terminal)

```sh
claude mcp add toolc --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- npx -y @toolc/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "toolc": {
      "command": "npx",
      "args": [
        "-y",
        "@toolc/cli"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "toolc": {
      "command": "npx",
      "args": [
        "-y",
        "@toolc/cli"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "toolc": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@toolc/cli"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "toolc": {
      "command": "npx",
      "args": [
        "-y",
        "@toolc/cli"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "toolc": {
      "command": "npx",
      "args": [
        "-y",
        "@toolc/cli"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_tools`: Meta-tool that searches the compressed tool catalogue.
- `call_tool`: Meta-tool that calls a tool found through search.

## FAQ

### Does it need an API key?

An ANTHROPIC_API_KEY enables the rewrite and consolidate passes; without it toolc serves a mirror of the original tool surface.

### Is it open source?

The engine is Apache-2.0 licensed, and a managed hosted service runs the same engine.

### How is it run locally?

Clone the repo, install with pnpm, write a config, then run compile and serve over stdio; the npm package is @toolc/cli.

### Can it front REST APIs?

Yes, a downstream can be an OpenAPI spec as well as an MCP server.

### Is Toolc free?

Yes. Toolc is open source, so you can use and self-host it for free.

### How do I add Toolc to Claude Code?

Run this command in your terminal: claude mcp add toolc --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- npx -y @toolc/cli

### What are the best alternatives to Toolc?

The closest alternatives to Toolc are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/toolc
