Frugal
Routing layer that sends each tool call to the cheapest capable provider and logs why
- Pricing
- Free
- Platforms
- self-hosted, CLI
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- today
Similar MCP servers
About Frugal
Frugal is a free MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.
Frugal sits between an agent and its tool providers. The agent describes a job such as a search, an extraction or a render, and Frugal picks the provider by policy: cheapest by default, fastest or premium on request, or pinned and denied for compliance, with automatic failover when a provider errors or returns nothing. Every response reports the provider used and cost in dollars, and the execute tool adds a one-line reason, so each routing decision can be audited.
Search and page extraction work with no keys through free options named in the README: a You.com free tier of about 100 queries per day, Marginalia, Wikipedia, a local go-readability extractor and Jina Reader. Adding a SearXNG URL, a Serper key or a You.com key gives the chain a stronger fallback. Policies live in a YAML config, with per-provider daily spend caps and a cooldown after rate-limit errors.
It ships as one Go binary, installed by a script that also registers it with Claude Desktop, Cursor, AnythingLLM and Claude Code. It can also serve Streamable HTTP, including a stateless mode for replicas behind a load balancer. The source is available under BUSL 1.1, converting to Apache 2.0.
Install
Run in a terminal
claude mcp add frugal -- npx -y frugal-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"frugal": {
"command": "npx",
"args": [
"-y",
"frugal-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"frugal": {
"command": "npx",
"args": [
"-y",
"frugal-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"frugal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"frugal-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"frugal": {
"command": "npx",
"args": [
"-y",
"frugal-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"frugal": {
"command": "npx",
"args": [
"-y",
"frugal-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
What it does
- Policy routing
- Order providers by cheapest, fastest or premium, or set an explicit preference list.
- Deny list
- Mark providers that must never be called, even when pinned.
- Automatic failover
- Falls through to the next provider on errors or empty results.
- Spend caps
- Daily budget per provider and a cooldown after rate-limit responses.
- Decision audit
- Responses include provider used, cost and a reason.
- Zero-key start
- Free search and extraction providers are enabled by default.
- Streamable HTTP mode
- Serve remote clients statelessly behind a load balancer.
Good for
- Cut the cost of agent web search by using free providers first
- Keep sensitive queries off paid providers with a deny list
- Audit which provider handled each tool call
- Cap daily spend on a paid search API
Pricing
Free
Source-available; you bring your own provider keys
Frugal FAQ
Does it need an account?
No. It uses your own keys and can be self-hosted.
Can it work without any API keys?
Yes. Search and extraction run on free providers out of the box, within their limits.
How do I install it?
Run the install script, then frugal mcp install to register it with detected clients.
What is the license?
Source-available under BUSL 1.1, converting to Apache 2.0.
Is Frugal free?
Yes. Frugal is free to use.
How do I add Frugal to Claude Code?
Run this command in your terminal: claude mcp add frugal -- npx -y frugal-mcp
What are the best alternatives to Frugal?
The closest alternatives to Frugal are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


