pl.piszczek/ai-economics
12 calculators for AI cost, energy and agent verification. Free API, no key.
Open source Open in the app JSON README (API)
About
12 calculators for AI cost, energy and agent verification. Free API, no key.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- pl.piszczek
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Open pull requests
- 2
- Last push
- 2026-09-03T12:45:20Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:53
- Updated
- 2026-08-29 04:01:53
- Origin id
pl.piszczek/ai-economics
README
# ai-economics-mcp
[](https://doi.org/10.5281/zenodo.21760145)
[](https://www.npmjs.com/package/@michalpiszczek/ai-economics-mcp) [](https://glama.ai/mcp/servers/pich/ai-economics-mcp) [](LICENSE)
**MCP server for AI economics.** Gives Claude, Cursor and any MCP client 12 calculators for
the questions that decide AI budgets: what tokens cost, what queries burn, and whether agent
work can be proven.
Listed in the official [MCP Registry](https://registry.modelcontextprotocol.io) as **`pl.piszczek/ai-economics`** (domain-verified). Wraps the free [piszczek.pl/tools](https://piszczek.pl/tools) API — no key, no sign-up,
stateless (inputs are never stored). The math is the same as the interactive calculators.
## Install
**Claude Desktop / Claude Code** (`claude_desktop_config.json` / `.mcp.json`):
```json
{
"mcpServers": {
"ai-economics": {
"command": "npx",
"args": ["-y", "@michalpiszczek/ai-economics-mcp"]
}
}
}
```
**Claude Code one-liner:**
```bash
claude mcp add ai-economics -- npx -y @michalpiszczek/ai-economics-mcp
```
## Tools
| Tool | Answers |
|---|---|
| `token_cost` | What do 1M tokens cost per month across GPT, Claude, Gemini, DeepSeek? |
| `context_window` | How many tokens is 50 pages, does it fit, what does carrying it cost? |
| `agent_hour` | What does one hour of an AI agent cost, fully loaded with verification? |
| `model_routing` | How much does routing to a cheaper tier save per year? |
| `llm_energy` | How much electricity does an AI query use? |
| `joules_per_verified_task` | Which model is most efficient per task that actually passes? |
| `token_burn` | What does org-wide token burn cost in money, kWh, CO₂? |
| `humanoid_energy` | How long can a humanoid robot run per charge? |
| `proof_adjusted_autonomy` | How autonomous is a "90% autonomous" agent once proof is required? |
| `revocation_exposure` | How long does a revoked token keep working across your stack? |
| `verification_bottleneck` | How many AI agents can a human review team absorb? |
| `proof_debt` | What does unverified AI work cost over time? |
All parameters are optional; defaults mirror the interactive calculators. Every response
includes `result`, `formula`, `interpretation` and a ready-to-quote `cite_as` sentence.
## Example
> **You:** how autonomous is our agent really? it completes 90% alone, evidence for 95%,
> 80% independently validated, 90% on time
>
> **Claude** (calls `proof_adjusted_autonomy`): PAA = 61.6% — supervised autonomy. The gap
> vs the claimed 90% is 28.4 pp, and the biggest lever is independent validation…
## Configuration
| Env var | Default | Purpose |
|---|---|---|
| `AI_ECONOMICS_API` | `https://piszczek.pl/tools/api` | Point at a self-hosted instance |
## Glama builds and releases
Glama generates its own Dockerfile from the
[build configuration](https://glama.ai/mcp/servers/pich/ai-economics-mcp/admin/dockerfile).
Use these settings:
- Build steps: `["npm ci --omit=dev"]`
- CMD arguments: `["mcp-proxy", "--", "node", "index.js"]`
- Environment variables: optional `AI_ECONOMICS_API`; no credentials required.
This is plain JavaScript: there is no `build` script or compilation step. Do not use
`pnpm run build` or `npm run build`. After syncing the repository, build the selected
commit and publish a Glama release from the successful test. A GitHub or npm release
alone does not trigger Glama's quality evaluation.
For local stdio use, the repository Dockerfile needs no proxy or exposed ports:
```bash
docker build -t ai-economics-mcp .
docker run -i --rm ai-economics-mcp
```
## Concepts behind the tools
- [Joule Wars](https://piszczek.pl/joule-wars) — the AI race for energy efficiency
- [Proof-Adjusted Autonomy](https://piszczek.pl/proof-adjusted-autonomy) — the metric of proven agent work
- [Revocation Exposure](https://piszczek.pl/glossary/revocation-exposure) — how long revoked authority keeps working
## Citing a result
Every tool response carries a `cite_as` sentence written to be quoted verbatim. For a document that has to survive review, DOIs and BibTeX for this server, the calculators and the three concepts they instrument are at [piszczek.pl/cite](https://piszczek.pl/cite).
## License
MIT. Concepts and calculators by [Michał Piszczek](https://piszczek.pl/michal-piszczek)
(CC BY 4.0 — attribution appreciated).