# Frugal

> Frugal is a free MCP server for ai models and llm tooling. Routing layer that sends each tool call to the cheapest capable provider and logs why. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** self-hosted, CLI
- **Repository:** https://github.com/brainsparker/frugal
- **MCP Registry name:** io.github.brainsparker/frugal
- **Categories:** [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add frugal -- npx -y frugal-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "frugal": {
      "command": "npx",
      "args": [
        "-y",
        "frugal-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "frugal": {
      "command": "npx",
      "args": [
        "-y",
        "frugal-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "frugal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "frugal-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "frugal": {
      "command": "npx",
      "args": [
        "-y",
        "frugal-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "frugal": {
      "command": "npx",
      "args": [
        "-y",
        "frugal-mcp"
      ]
    }
  }
}
```

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

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