Skip to main content

AI-Cost-CLI & MCP (aicost-mcp)

PyPI npm License: MIT Python 3.9+ MCP Registry

A terminal-based AI API cost calculator, monthly workload budget estimator, recommender, and Model Context Protocol (MCP) server. Covers 60+ curated multimodal models plus 470+ live models dynamically, compares Direct providers vs. Aggregators/Gateways, factors in prompt caching and Batch API discounts, and converts across 200+ currencies.

Preview: Direct vs. Aggregator Comparison

Compare the effective cost of using frontier models directly vs. through gateways like OpenRouter, including platform fees, context windows, and prompt-caching rates.

          Comparison: claude-sonnet-5.5 vs openrouter/claude-sonnet-5.5          
┏━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Attribute          ┃    claude-sonnet-5.5    ┃  openrouter/claude-sonnet-5.5  ┃
┡━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ Provider           │        Anthropic        │           OpenRouter           │
├────────────────────┼─────────────────────────┼────────────────────────────────┤
│ Source             │         Direct          │           Aggregator           │
├────────────────────┼─────────────────────────┼────────────────────────────────┤
│ Platform Fee       │          0.0%           │              5.5%              │
├────────────────────┼─────────────────────────┼────────────────────────────────┤
│ Context Window     │           1M            │               1M               │
├────────────────────┼─────────────────────────┼────────────────────────────────┤
│ Input Cost         │    2.0000 USD (/1M)     │        2.1100 USD (/1M)        │
├────────────────────┼─────────────────────────┼────────────────────────────────┤
│ Cached Input       │    0.1000 USD (/1M)     │        0.1055 USD (/1M)        │
├────────────────────┼─────────────────────────┼────────────────────────────────┤
│ Output / Unit Cost │    10.0000 USD (/1M)    │       10.5500 USD (/1M)        │
└────────────────────┴─────────────────────────┴────────────────────────────────┘

Supported Models (Curated Frontier + 470+ Live Catalog)

Flagship Text & Reasoning Models

Model Provider Input/1M Cached/1M Output/1M Context
GPT-6.2 Astra (gpt-6.2-astra) OpenAI $8.00 $0.40 $40.00 1.05M
GPT-6.2 Sol (gpt-6.2-sol) OpenAI $2.00 $0.10 $10.00 1.05M
GPT-6.1 Terra (gpt-6.1-terra) OpenAI $1.00 $0.05 $5.00 1.05M
GPT-6 Luna (gpt-6-luna) OpenAI $0.10 $0.01 $0.50 1.05M
o3 / o3-Pro (o3, o3-pro) OpenAI $2.00 / $20 $0.50 / - $8.00 / $80 200K
Claude Fable 5.2 (claude-fable-5.2) Anthropic $8.00 $0.20 $40.00 1M
Claude Opus 5.5 (claude-opus-5.5) Anthropic $4.00 $0.20 $20.00 1M
Claude Sonnet 5.5 (claude-sonnet-5.5) Anthropic $2.00 $0.10 $10.00 1M
Claude Haiku 5.5 (claude-haiku-5.5) Anthropic $0.10 $0.01 $0.50 1M
Gemini 4 Neon (gemini-4-neon) Google $3.00 $0.15 $15.00 1M
Gemini 4 Carbon / Argon (gemini-4-carbon) Google $2.00 $0.10 $10.00 1M
Gemini 4 Hydrogen (gemini-4-hydrogen) Google $1.50 $0.075 $7.50 1M
Gemini 3.8 Flash (gemini-3.8-flash) Google $0.825 $0.0825 $4.125 1M
Grok 4.7 (grok-4.7) xAI $2.00 $0.50 $6.00 500K
DeepSeek V4 Pro (deepseek-v4-pro) DeepSeek $0.90 $0.20 $1.50 1M
DeepSeek V4.1 Flash (deepseek-v4.1-flash) DeepSeek $0.15 $0.003 $0.60 1M
Qwen 4 Max (qwen4-max) Alibaba Qwen $1.425 - $4.275 1M
Llama 4 Maverick / Scout (llama-4-maverick) Meta $0.35 / $0.10 $0.17 / - $1.00 / $0.30 512K / 1.3M
Mistral Large 4 (mistral-large-4) Mistral $0.70 - $2.10 1M
Kimi K3.1 Pro (kimi-k3.1-pro) Moonshot $0.253 - $8.80 1M
MiniMax M3.1 Flash (minimax-m3.1-flash) MiniMax $0.075 - $0.30 1M

Image, Video & Audio Models

Model Provider Price Billing Unit Type
GPT-Image 2.6 Sunburst (gpt-image-2.6-sunburst) OpenAI $0.08 per image Image
GPT-Image 2.6 Flare (gpt-image-2.6-flare) OpenAI $0.025 per image Image
Imagen 4 Fast / Standard / Ultra Google $0.02 / $0.04 / $0.06 per image Image
Flux 1.1 Pro / Ultra Black Forest Labs $0.04 / $0.06 per image Image
Veo 3.1 Fast / Standard (veo-3.1) Google $0.10 / $0.40 per second Video
Lyria 3 Clip / Pro (lyria-3-pro) Google $0.04 / $0.08 per clip / song Music
Whisper (whisper) OpenAI $0.006 per minute Speech-to-Text
TTS Standard / HD OpenAI $15 / $30 per 1M chars Text-to-Speech

Browse curated models via aicost list, include previous-gen models with --include-legacy, or query all 470+ live models with aicost list --live!

Features

  • Always-Current Hybrid Catalog: Weekly automated discovery of newly released flagship models + on-demand fallback to 470+ live OpenRouter models (never hits "Model not found" on new releases).
  • Dynamic Direct vs. Aggregator Math: Prefix any model with openrouter/ (e.g., openrouter/gpt-6.2-astra) to instantly compare Direct billing vs. OpenRouter's 5.5% fee.
  • Prompt Caching & Batch Discounts: First-class support for --cached-input read rates (up to 95% savings) and --batch API discounts.
  • Monthly Workload Estimator (aicost estimate): Forecast daily, 30-day, and annual API spend from expected request traffic.
  • 200+ Currencies with Offline Resilience: Powered by a 3-tier CDN currency engine (TRY, EUR, GBP, AZN, AED, JPY, etc.) with 24-hour local cache.
  • Dual MCP Server Ecosystem (npx & uvx): Zero-install MCP integration via npm (aicost-mcp) or PyPI (aicost-cli).

Installation

Add to your MCP configuration (claude_desktop_config.json or .cursor/mcp.json):

{
  "mcpServers": {
    "aicost": {
      "command": "npx",
      "args": ["-y", "aicost-mcp"]
    }
  }
}

Python CLI (pip / uv)

pip install -U aicost-cli

CLI Usage

List & Filter Models

aicost list --currency TRY
aicost list --provider Anthropic
aicost list --live --provider Cohere
aicost list --tag agentic --sort input --json

Calculate Cost (with Caching & Batch Support)

# Frontier model with prompt caching
aicost calc claude-opus-5.5 --input 200000 --cached-input 800000 --output 100000 --currency USD

# Batch API (-50%) calculation
aicost calc gpt-6.2-astra --input 1000000 --output 500000 --batch

# Dynamic OpenRouter aggregator fee breakdown on ANY model
aicost calc openrouter/gemini-4-carbon --input 1000000 --output 500000 --currency TRY

# Multimodal unit calculation (seconds, minutes, images)
aicost calc veo-3.1 --units 8 --currency USD

Project Monthly Workload Budget

aicost estimate claude-sonnet-5.5 --requests-per-day 2500 --input 1800 --output 450 --currency USD

Compare 2+ Models Side-by-Side

aicost compare gpt-6.2-astra claude-opus-5.5 gemini-4-neon grok-4.7 --currency USD

Get Task Recommendations

aicost recommend "fast cheap agentic coding" --max-cost 1.0 --currency USD

Sync Latest Pricing, Live 470+ Catalog & Exchange Rates

aicost sync

Registries

Community & Governance

License

MIT — see LICENSE for details. Developed by Ufuk Aydın.

Metadata

Release files for aicost-cli 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aicost-cli 1.3.0
File Size Uploaded Provenance Actions
aicost_cli-1.3.0.tar.gz 38.6 kB With provenance Details for aicost_cli-1.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aicost-cli 1.3.0
File Interpreter ABI Platform Actions
aicost_cli-1.3.0-py3-none-any.whl Python 3 none any Details for aicost_cli-1.3.0-py3-none-any.whl

Total release size: 71.8 kB

Release files / aicost_cli-1.3.0.tar.gz

Download URL aicost_cli-1.3.0.tar.gz
Size 38.6 kB
Tags Source
SHA-256 checksum
How to use checksums
ff4c704d032a7d8583a1dde745a10c25bcd698fe815fa2d423995f7ed7ce54e6
BLAKE2b-256 checksum
How to use checksums
469d6ccb093b1fccc38ae0b02fca26c371e3baa4873783b16a0850ef365813f7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / aicost_cli-1.3.0-py3-none-any.whl

Download URL aicost_cli-1.3.0-py3-none-any.whl
Size 33.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3d2daa7b799daec424474b872e41ea53b7e4722304829ceca5dcc7baadd2b335
BLAKE2b-256 checksum
How to use checksums
dd0368717c5b5178c313649d31ccb6268a2ebe241a008423e3ecb87904013a78
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for aicost-cli 1.3.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aicost_cli-1.3.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page