# Toolkien

> Toolkien is an open-source MCP server for ai models and llm tooling. One MCP gateway for all your MCP servers, with code mode, permissions and audit. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Toolkien sits between your AI clients and your other remote MCP servers. Instead of loading hundreds of tool schemas, the agent calls tools_search, reads compact TypeScript declarations with tools_describe, then sends one script to execute, which runs in an isolated Deno sandbox and chains every call.

Each call goes through a bridge that checks a permission level of allow, ask or block, so writes can pause for human approval and resume without repeating earlier calls. Credentials are encrypted per workspace, content is not logged and the audit trail keeps metadata only. A directory offers 100 preconfigured remote servers such as GitHub, Linear, Notion, Sentry, Stripe and Supabase.

The site's token and round-trip comparison is labelled an illustrative example, not a benchmark. Toolkien is AGPL-3.0 open source and free during early access.

## Features

- **Code mode:** One TypeScript script replaces many tool calls.
- **Per-tool permissions:** Allow, ask or block each call.
- **Approvals:** Writes can wait for a human and resume later.
- **Audit trail:** Metadata-only log of calls.
- **Server directory:** 100 popular remote servers preconfigured.
- **Connect once:** Add a tool once and reach it from every client.

## Good for

- Triage issues across GitHub, Linear and Slack in one script
- Give a team shared tools with approval gates
- Cut context cost from long tool lists
- Review what an agent called afterwards

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http toolkien https://toolkien.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://toolkien.dev/mcp
```

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

```json
{
  "mcpServers": {
    "toolkien": {
      "url": "https://toolkien.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "toolkien": {
      "type": "http",
      "url": "https://toolkien.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "toolkien": {
      "serverUrl": "https://toolkien.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "toolkien": {
      "type": "http",
      "url": "https://toolkien.dev/mcp"
    }
  }
}
```

## Tools

- `tools_search`: Searches workspace tools by text and returns paths with summaries.
- `tools_describe`: Returns compact TypeScript declarations for chosen tools.
- `execute`: Runs one sandboxed script that chains tool calls.

## FAQ

### Is it open source?

Yes, under AGPL-3.0, and also offered as a managed service.

### What does it cost?

It is free during early access.

### Where do scripts run?

In an isolated Deno sandbox with an egress proxy.

### Are the speed figures real?

The site calls its comparison illustrative, not a benchmark.

### Is Toolkien free?

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

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

Run this command in your terminal: claude mcp add --transport http toolkien https://toolkien.dev/mcp

### What are the best alternatives to Toolkien?

The closest alternatives to Toolkien 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/toolkien
