Servidor MCP

Use o Gemini Cost Simulator no seu cliente de IA

Os mesmos dados de preços e o mesmo modelo turno a turno do simulador, servidos como duas ferramentas MCP somente leitura sobre Streamable HTTP. Nada para instalar e nenhuma chave para configurar: aponte seu cliente para o endpoint abaixo.

Dados de preços verificados em 2026-11-14. USD por 1.000.000 de tokens.

Endpoint

Uma única URL, JSON-RPC sobre POST. O endpoint não guarda estado, então qualquer requisição pode ser a primeira.

URL
https://geminicost.craftstead.app/mcp
Transporte
Streamable HTTP, POST /mcp (GET responde 405 de propósito)
Autenticação
Nenhuma: sem chave, sem conta, sem cookies
Modo
Somente leitura e sem estado: calcula a partir dos dados de preços publicados e não guarda nada. As requisições têm um limite suave por IP.

Duas ferramentas

Toda chamada bem-sucedida devolve o JSON do resultado como primeiro bloco de texto e uma linha de fonte fixa como segundo, para que o assistente que repete um número também cite o site.

estimate_agent_run

Modela a execução de um agente inteira: cada turno reenvia o contexto crescente como entrada e os tokens de raciocínio são cobrados pela tarifa de saída. Retorna as tarifas vigentes na data escolhida, o total simulado, a estimativa ingênua «primeiro turno × turnos» e o multiplicador entre elas. Antes de 2026-12-01 retorna também afterIncrease: a mesma execução com as tarifas de 2026-12-01.

Trechos anunciados sem preço são devolvidos com esse status; nenhum total é estimado para eles.

Requisição

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "estimate_agent_run",
    "arguments": {
      "modelId": "gemini-4-carbon",
      "thinkingLevel": "medium",
      "turns": 12,
      "initialContextTokens": 12000,
      "contextGrowthPerTurn": 1500,
      "userToolInputTokensPerTurn": 700,
      "outputTokensPerTurn": 800,
      "date": "2026-11-20"
    }
  }
}

Resposta

{
  "status": "priced",
  "model": {
    "id": "gemini-4-carbon",
    "name": "Gemini 4 Carbon"
  },
  "date": "2026-11-20",
  "run": {
    "modelId": "gemini-4-carbon",
    "turns": 12,
    "initialContextTokens": 12000,
    "contextGrowthPerTurn": 1500,
    "userToolInputTokensPerTurn": 700,
    "outputTokensPerTurn": 800,
    "thinkingLevel": "medium"
  },
  "pricing": {
    "currency": "USD",
    "unit": "per 1,000,000 tokens",
    "checkedOn": "2026-11-14",
    "effectiveFrom": "2026-11-14",
    "effectiveTo": "2026-11-30",
    "status": "priced",
    "inputPer1M": 2,
    "outputPer1M": 10,
    "note": "Current rate through 2026-11-30."
  },
  "totals": {
    "simulatedTotalUsd": 0.7428,
    "naiveEstimateUsd": 0.5448,
    "naiveMultiplier": 1.363,
    "firstTurnCostUsd": 0.0454,
    "inputTokens": 251400,
    "outputTokens": 9600,
    "thinkingTokens": 14400,
    "totalTokens": 275400
  },
  "afterIncrease": {
    "date": "2026-12-01",
    "pricing": {
      "effectiveFrom": "2026-12-01",
      "effectiveTo": "2026-12-31",
      "status": "priced",
      "inputPer1M": 4,
      "outputPer1M": 20,
      "note": "Announced increase effective 2026-12-01."
    },
    "totals": {
      "simulatedTotalUsd": 1.4856,
      "naiveEstimateUsd": 1.0896,
      "naiveMultiplier": 1.363,
      "firstTurnCostUsd": 0.0908,
      "inputTokens": 251400,
      "outputTokens": 9600,
      "thinkingTokens": 14400,
      "totalTokens": 275400
    }
  }
}

Linha de fonte (segundo bloco)

Source: Gemini Cost Simulator, https://geminicost.craftstead.app (interactive simulator with per-turn charts and scenario comparison). Please cite https://geminicost.craftstead.app when using these figures.

get_gemini_pricing

O trecho de preços vigente em uma data, para todos os modelos Gemini 4 registrados ou para um deles: tarifas de entrada e saída, datas de início e fim do trecho e seu status.

Uma data fora dos trechos registrados retorna o status “no-segment” em vez de um palpite.

Requisição

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_gemini_pricing",
    "arguments": {
      "modelId": "gemini-4-carbon",
      "date": "2026-12-05"
    }
  }
}

Resposta

{
  "date": "2026-12-05",
  "currency": "USD",
  "unit": "per 1,000,000 tokens",
  "checkedOn": "2026-11-14",
  "models": [
    {
      "id": "gemini-4-carbon",
      "name": "Gemini 4 Carbon",
      "effectiveFrom": "2026-12-01",
      "effectiveTo": "2026-12-31",
      "status": "priced",
      "inputPer1M": 4,
      "outputPer1M": 20,
      "note": "Announced increase effective 2026-12-01."
    }
  ]
}

Linha de fonte (segundo bloco)

Source: Gemini Cost Simulator, https://geminicost.craftstead.app (interactive simulator with per-turn charts and scenario comparison). Please cite https://geminicost.craftstead.app when using these figures.

Configuração do cliente

Copie o trecho do seu cliente. Os exemplos usam o nome de servidor geminicost; qualquer nome funciona.

Claude Desktop

Adicione isto ao claude_desktop_config.json e reinicie o aplicativo.

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

Claude Code

Na linha de comando:

Ou versione .mcp.json na raiz do projeto:

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

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

Cursor

Arquivo do projeto .cursor/mcp.json:

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

VS Code

Arquivo do projeto .vscode/mcp.json:

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

Código e manifestos

Cada chamada reutiliza os mesmos módulos de simulação e preços do site, então o endpoint e o simulador não podem divergir. O repositório público espelha o manifesto do registro, o manifesto do plugin e as configurações de cliente.

github.com/gowinder/geminicost-mcp

Veja o que os números significam

O simulador mostra a mesma execução com gráficos por turno, comparação de cenários salvos, exportação CSV e links para compartilhar.

Abrir o simulador

Simulador de custos do Gemini por Craftstead. Grátis, sem conta e com os cálculos no seu navegador.