@ratel-ai/mcp-server
Package reference for the MCP server, CLI, and library that power Ratel Local.
@ratel-ai/mcp-server is the TypeScript package behind Ratel Local. It
connects upstream MCP servers to one searchable catalog and exposes Ratel's capability
tools to Claude Code, Codex, Cursor, and other MCP clients.
Start with Ratel Local
Claude Code and Codex can follow the Ratel Local quickstart to install the package, migrate an existing MCP setup, and verify capability search. Cursor uses manual MCP configuration.
Entry points
| Entry point | Purpose |
|---|---|
ratel-mcp | Configure upstreams, serve the catalog, manage skills, and run the local UI |
createMcpServer | Expose a ToolCatalog as an MCP server from your own process |
buildGatewayFromConfig | Connect configured upstreams and build the catalog used by the server |
Install the documented release with npm install @ratel-ai/mcp-server@0.4.0, or run its
CLI with npx -y @ratel-ai/mcp-server@0.4.0.
Operational guides
| Task | Guide |
|---|---|
| add, inspect, edit, or remove upstreams | MCP servers |
| migrate native Claude Code or Codex entries | Import or link |
| authorize HTTP or SSE upstreams | OAuth upstreams |
| manage skills and the Claude Code preload hook | Managing skills |
| manage configuration from the browser | Browser UI |
| inspect local events and estimated savings | Statusline & telemetry |
| create the gateway from Node code | Embed as a library |
| diagnose setup and recover config files | Troubleshooting |
The package is published on npm,
with source in ratel-ai/ratel-local. The
identifiers @ratel-ai/mcp-server and ratel-mcp remain unchanged.