English Français العربية

pl.piszczek/ai-economics

السجل الرسمي الأمن

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

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع pl.piszczek/ai-economics؟

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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 (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"
            }
        }
    }
}

متغيرات البيئة

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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).

الأسئلة الشائعة

ما هو pl.piszczek/ai-economics؟

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

كيف أثبّت pl.piszczek/ai-economics؟

يعمل على جهازك. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج pl.piszczek/ai-economics إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل pl.piszczek/ai-economics مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون pl.piszczek/ai-economics؟

ينشره pich. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.