English Français العربية

pl.piszczek/ai-economics

Official registry Security

12 calculators for AI cost, energy and agent verification. Free API, no key.

Source code Website Documentation

What can you do with pl.piszczek/ai-economics?

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @michalpiszczek/ai-economics-mcp
Claude Code 
claude mcp add ai-economics -e 'AI_ECONOMICS_API=https://piszczek.pl/tools/api' -- npx -y @michalpiszczek/ai-economics-mcp@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ai-economics": {
            "command": "npx",
            "args": [
                "-y",
                "@michalpiszczek/ai-economics-mcp@1.0.1"
            ],
            "env": {
                "AI_ECONOMICS_API": "https://piszczek.pl/tools/api"
            }
        }
    }
}

Environment variables

  • AI_ECONOMICS_API Override the API base URL (defaults to https://piszczek.pl/tools/api). No API key is required.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ai-economics-mcp
  2. Install
  3. Tools
  4. Example
  5. Configuration
  6. Glama builds and releases
  7. Concepts behind the tools
  8. Citing a result
  9. License

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

ToolAnswers
token_costWhat do 1M tokens cost per month across GPT, Claude, Gemini, DeepSeek?
context_windowHow many tokens is 50 pages, does it fit, what does carrying it cost?
agent_hourWhat does one hour of an AI agent cost, fully loaded with verification?
model_routingHow much does routing to a cheaper tier save per year?
llm_energyHow much electricity does an AI query use?
joules_per_verified_taskWhich model is most efficient per task that actually passes?
token_burnWhat does org-wide token burn cost in money, kWh, CO₂?
humanoid_energyHow long can a humanoid robot run per charge?
proof_adjusted_autonomyHow autonomous is a "90% autonomous" agent once proof is required?
revocation_exposureHow long does a revoked token keep working across your stack?
verification_bottleneckHow many AI agents can a human review team absorb?
proof_debtWhat 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 varDefaultPurpose
AI_ECONOMICS_APIhttps://piszczek.pl/tools/apiPoint 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

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).

Frequently asked questions

What is pl.piszczek/ai-economics?

12 calculators for AI cost, energy and agent verification. Free API, no key.

How do I install pl.piszczek/ai-economics?

It runs on your machine. In Claude Code: claude mcp add ai-economics -e 'AI_ECONOMICS_API=https://piszczek.pl/tools/api' -- npx -y @michalpiszczek/ai-economics-mcp@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does pl.piszczek/ai-economics need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is pl.piszczek/ai-economics open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains pl.piszczek/ai-economics?

It is published by pich. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.