AI-Cost-CLI & MCP (aicost-mcp)
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) |
$3.00 | $0.15 | $15.00 | 1M | |
Gemini 4 Carbon / Argon (gemini-4-carbon) |
$2.00 | $0.10 | $10.00 | 1M | |
Gemini 4 Hydrogen (gemini-4-hydrogen) |
$1.50 | $0.075 | $7.50 | 1M | |
Gemini 3.8 Flash (gemini-3.8-flash) |
$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 | $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) |
$0.10 / $0.40 | per second | Video | |
Lyria 3 Clip / Pro (lyria-3-pro) |
$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 withaicost 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-inputread rates (up to 95% savings) and--batchAPI 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
MCP Server (npx — Recommended for Claude Desktop, Cursor, Windsurf, VS Code)
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
- PyPI —
aicost-cli - npm —
aicost-mcp - MCP Registry —
io.github.ufhouck/aicost-cli - Smithery.ai
- Skills.sh
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.