Gemini Cost Simulator

● Active

io.github.gowinder/geminicost

Gemini 4 agent-run cost simulator over MCP: true per-turn totals vs naive estimates.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "geminicost": {
      "url": "https://geminicost.craftstead.app/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http geminicost https://geminicost.craftstead.app/mcp
VS Code
code --add-mcp '{"name":"geminicost","type":"http","url":"https://geminicost.craftstead.app/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
AI & Agents
Version
1.0.0
Registry
active
Published
11/18/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: Gemini Cost Simulator is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit 5 days ago (Nov 17, 2026), 0 open issues.
Official registry
Active
Published as io.github.gowinder/geminicost in the official MCP registry, version 1.0.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to geminicost.craftstead.app: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 00:07 UTCStatus history & uptime →
● Working148 msprotocol 2025-06-18v1.0.0tools

The endpoint answered the MCP handshake as "Gemini Cost Simulator" and listed 2 tools. Answering since Nov 18, 2026.

Context cost ≈ 684 tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 2 tools.

Tools (2)

  • estimate_agent_run8 params

    Turn-by-turn cost of a Gemini 4 agent run: every turn re-sends the growing context as input, thinking tokens are billed at the output rate. Returns the rates in force on the chosen date, the simulated total, the naive first-turn × turns estimate and their multiplier. Before the 2026-12-01 price change it also returns afterIncrease: the same run priced at the announced 2026-12-01 rates.

    Show parameters
    • modelIdstringrequiredGemini 4 model to price.
    • thinkingLevelstringrequiredThinking budget. Thinking tokens are billed at the output price: off = 0×, low ≈0.5×, medium ≈1.5×, high ≈3× the visible output tokens.
    • turnsnumberrequiredNumber of turns (separate API calls) in the run.
    • initialContextTokensnumberrequiredSystem prompt, tool definitions and documents sent on turn 1.
    • contextGrowthPerTurnnumberrequiredNet history added after each completed turn; billed from turn 2 onward.
    • userToolInputTokensPerTurnnumberrequiredNew user/tool content billed on top of the context each turn.
    • outputTokensPerTurnnumberrequiredVisible answer tokens per turn, excluding thinking.
    • datestringISO date (YYYY-MM-DD) that selects the price segment in force that day. Defaults to today (UTC).
  • get_gemini_pricing2 params

    Price segment in force on a date for every recorded Gemini 4 model, or for one model: input and output USD per 1,000,000 tokens, the segment start and end dates and its status. Segments marked announced-unpriced have no published values and are reported as such.

    Show parameters
    • modelIdstringRestrict the answer to one model. Omit for all recorded models.
    • datestringISO date (YYYY-MM-DD) that selects the price segment in force that day. Defaults to today (UTC).

Checked by Serverdex with a plain initialize + tools/list call to geminicost.craftstead.app/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 18, 2026
Stars
0
Forks
0
Last push
Nov 17, 2026
License
MIT

From the README

Gemini Cost Simulator MCP server Read-only MCP server for Gemini 4 agent-run costs: estimate what a whole agent run really costs turn by turn, compare the simulated total with the naive "first turn × turns" estimate, and read the list price segment in force on any date. • Endpoint: https://geminicost.craftstead.app/mcp (MCP over Streamable HTTP, JSON-RPC POST) • Authentication: none. No key, no account, no cookies. • Mode: read-only, stateless, softly rate limited per client IP. • Website: — interactive simulator with per-turn charts and scenario comparison: This repository is the public mirror of the server: the Official MCP Registry manifest, the Agent Plugins package, client configuration samples and this documentation. The endpoint itself runs in the site repository as a Cloudflare Pages Function and reuses the site's own simulation and pricing modules, so a tool call and the simulator cannot disagree. Tools The run model, in one paragraph: every turn is a separate API call that re-sends the whole context, so the full context is billed as input on every turn; contextGrowthPerTurn is the net history added after each completed turn (it first applies to turn 2); new user/tool content for the current turn is billed on top through userToolInputTokensPerTurn; thinking tokens are billed at the output price at a planning heuristic of 0×, 0.5×, 1.5× or 3× the visible output tokens.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://geminicost.craftstead.app/mcp

The most-starred AI & Agents servers in the index, with their live-check result.

ServerStarsLast pushLive check
Ruflo81,994Nov 2026Local / not checked
Claude Flow81,985Nov 2026Local / not checked
CodeBurn11,880Nov 2026Local / not checked
Kaneo9,825Nov 2026Local / not checked
Ha MCP7,958Nov 2026Local / not checked

Gemini Cost Simulator: questions people ask

Is Gemini Cost Simulator a remote or a local MCP server?
According to its entry in the official MCP registry, Gemini Cost Simulator ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does Gemini Cost Simulator need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is Gemini Cost Simulator safe to use?
Looks healthy: Gemini Cost Simulator is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Gemini Cost Simulator still maintained?
Active: the repository's last commit 5 days ago. Last push Nov 17, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
What tools does Gemini Cost Simulator expose?
2 tools as listed by the server itself during the live check, including estimate_agent_run, get_gemini_pricing. The full list with parameters is in the Live check section above.
How do I add Gemini Cost Simulator to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
  1. UrlChartRender charts as PNG images from a URL — Google Image Charts / Image-Charts compatible API.
  2. EldertongueOld English dictionary over MCP: headwords, inflection tables, form ID, Beowulf citations.
Browse all AI & Agents →

Add the badge to your site

Show visitors that Gemini Cost Simulator is listed here — it’s also the link we check for a free listing.

Gemini Cost Simulator — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-gowinder-geminicost?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Gemini Cost Simulator — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Gemini Cost Simulator — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-gowinder-geminicost?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-gowinder-geminicost) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-gowinder-geminicost) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-gowinder-geminicost)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-gowinder-geminicost"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-gowinder-geminicost"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-gowinder-geminicost"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).