npm @michalpiszczek/ai-economics-mcpstdioMITupdated 8d ago
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.
What can you do with ai economics?
ai-economics-mcp
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 as pl.piszczek/ai-economics (domain-verified). Wraps the free 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):
{
"mcpServers": {
"ai-economics": {
"command": "npx",
"args": ["-y", "@michalpiszczek/ai-economics-mcp"]
}
}
}
Claude Code one-liner:
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. 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:
docker build -t ai-economics-mcp .
docker run -i --rm ai-economics-mcp
Concepts behind the tools
- Joule Wars — the AI race for energy efficiency
- Proof-Adjusted Autonomy — the metric of proven agent work
- 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.
License
MIT. Concepts and calculators by Michał Piszczek (CC BY 4.0 — attribution appreciated).
Install
Add ai economics to your client. Pick the one you use.
claude mcp add ai-economics-mcp -- npx -y @michalpiszczek/ai-economics-mcpcodex mcp add ai-economics-mcp -- npx -y @michalpiszczek/ai-economics-mcpamp mcp add ai-economics-mcp -- npx -y @michalpiszczek/ai-economics-mcp{
"mcpServers": {
"ai-economics-mcp": {
"command": "npx",
"args": [
"-y",
"@michalpiszczek/ai-economics-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"ai-economics-mcp": {
"command": "npx",
"args": [
"-y",
"@michalpiszczek/ai-economics-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"ai-economics-mcp","command":"npx","args":["-y","@michalpiszczek/ai-economics-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"ai-economics-mcp": {
"command": "npx",
"args": [
"-y",
"@michalpiszczek/ai-economics-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"ai-economics-mcp": {
"command": "npx",
"args": [
"-y",
"@michalpiszczek/ai-economics-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"ai-economics-mcp": {
"command": "npx",
"args": [
"-y",
"@michalpiszczek/ai-economics-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"ai-economics-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@michalpiszczek/ai-economics-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"ai-economics-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@michalpiszczek/ai-economics-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @michalpiszczek/ai-economics-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
12 tools
ai economics exposes 12 tools to a connected agent.
- 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?
Score
77 / 100
Good
- Documentation25/25
- Maintenance19/25
- Trust13/20
- Capability8/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 1 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 12 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.1Latest | Aug 2, 2026 |