# Gemini Cost Simulator

> Gemini Cost Simulator is a free MCP server for ai models and llm tooling. Read-only MCP server that estimates multi-turn Gemini agent run costs and pricing by date. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI
- **Website:** https://geminicost.craftstead.app
- **Repository:** https://github.com/gowinder/geminicost-mcp
- **MCP Registry name:** io.github.gowinder/geminicost
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-18

## About

The README describes a remote MCP server that models what a full agent run costs on the Gemini 4 model family, turn by turn. Each turn is treated as a fresh API call that re-sends the accumulated context, so the server bills that context as input every time, plus new tool input and output tokens, with thinking tokens priced at the output rate using a planning heuristic.

Two tools are exposed: one simulates a run and compares the total with a naive first-turn-times-turns estimate, and the other returns the list price segment in force on a given date. When a date falls before the announced 2026-12-01 price change, the run result also shows the same run priced at the new rates.

The endpoint needs no key or account and is stateless and rate limited per client IP. The README says the figures are estimates of list prices rather than measurements of a real account, and points to the upstream pricing sources to check before committing spend.

## Features

- **Turn-by-turn run simulation:** Models each turn as a call that resends the full growing context, plus new tool input and output tokens.
- **Naive estimate comparison:** Shows the simulated total next to a first-turn-times-turns estimate and the resulting multiplier.
- **Dated price lookup:** Returns the input and output USD rates per million tokens in force on a chosen date.
- **Announced price change view:** Re-prices a run at the 2026-12-01 Gemini 4 rates when the chosen date precedes the increase.
- **No-auth remote endpoint:** Served over Streamable HTTP with no key, account or cookies, and works with common MCP clients.

## Good for

- Estimating the API cost of a multi-step Gemini agent before deploying it
- Comparing current Gemini 4 prices with the announced December 2026 increase
- Giving an AI assistant access to Gemini price lookups for a given date
- Checking how thinking token settings change the projected run cost

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http geminicost https://geminicost.craftstead.app/mcp
```

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

```sh
https://geminicost.craftstead.app/mcp
```

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

```json
{
  "mcpServers": {
    "geminicost": {
      "url": "https://geminicost.craftstead.app/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "geminicost": {
      "type": "http",
      "url": "https://geminicost.craftstead.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "geminicost": {
      "serverUrl": "https://geminicost.craftstead.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "geminicost": {
      "type": "http",
      "url": "https://geminicost.craftstead.app/mcp"
    }
  }
}
```

## Tools

- `estimate_agent_run`: Simulates a multi-turn agent run's cost against the naive estimate, with the rates in force on a date.
- `get_gemini_pricing`: Returns the Gemini price segment in force on a date for one or all recorded models.

## FAQ

### Does the server require an API key or account?

No. The README states there is no key, no account and no cookies, and the endpoint is read-only and stateless.

### Which models are covered?

The tools accept gemini-4-hydrogen, gemini-4-carbon and gemini-4-argon.

### How does it handle dates with no published price?

It returns a successful answer with status announced-unpriced, null rates and null totals rather than inventing a number.

### Which clients can connect?

The README gives configuration samples for Claude Desktop, Claude Code, Cursor and VS Code using the remote URL.

### Is Gemini Cost Simulator free?

Yes. Gemini Cost Simulator is free to use.

### How do I add Gemini Cost Simulator to Claude Code?

Run this command in your terminal: claude mcp add --transport http geminicost https://geminicost.craftstead.app/mcp

### What are the best alternatives to Gemini Cost Simulator?

The closest alternatives to Gemini Cost Simulator are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [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.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/gemini-cost-simulator
