{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7xuwkhdpwhpe","handle":"citadel-predict-mcp","url":"https://wellknown.network/agents/citadel-predict-mcp","links":{"self":"https://wellknown.network/agents/citadel-predict-mcp/record.json","html":"https://wellknown.network/agents/citadel-predict-mcp","markdown":"https://wellknown.network/agents/citadel-predict-mcp/record.md","api":"https://wellknown.network/api/v1/agents/citadel-predict-mcp","status":"https://wellknown.network/api/v1/agents/citadel-predict-mcp/status","claim":"https://wellknown.network/agents/citadel-predict-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/citadel-predict-mcp/claim.json","badge":"https://wellknown.network/agents/citadel-predict-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/citadel-predict-mcp/history","tools":"https://wellknown.network/api/v1/agents/citadel-predict-mcp/tools"},"ard":{"identifier":"urn:air::server:citadel-predict-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"citadel-predict-mcp","summary":"Model Context Protocol (MCP) server for Citadel Predict pre-execution AI agent cost estimation","description":"# citadel-predict-mcp\n\n[![Python Versions](https://img.shields.io/pypi/pyversions/citadel-predict-mcp.svg)](https://pypi.org/project/citadel-predict-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n**Model Context Protocol (MCP) server for Citadel Predict pre-execution AI agent cost estimation.**\n\n`citadel-predict-mcp` connects your hosted [Citadel Predict API](https://github.com/Athullvr/Citadel) directly into **Claude Desktop** and **Claude Code** via a local standard I/O (stdio) MCP server.\n\nWith this server configured, Claude can natively estimate token usage ranges ($low, expected, high$) and flag out-of-distribution risks for autonomous workflows **before running them**—without requiring manual CLI execution.\n\n---\n\n## Features\n\n- ⚡ **Native Claude Tool Calling**: Claude automatically decides when to call `estimate_agent_cost` when planning or dispatching tasks.\n- 🔒 **Zero Network Exposure**: Runs strictly as a local `stdio` subprocess spawned by Claude Desktop / Claude Code.\n- 🎯 **Pre-Execution Guardrails**: Predicts token consumption bounds before multi-step tools or reasoning loops execute.\n- 🛡️ **User-Friendly Error Handling**: Catches authentication, rate-limiting, and validation issues, presenting clear, actionable suggestions to Claude rather than raw stack traces.\n\n---\n\n## Installation\n\nInstall the package via `pip`:\n\n```bash\npip install citadel-predict-mcp\n```\n\n*(For local development from the repository root: `pip install -e packages/citadel-predict-mcp`)*\n\nVerifying installation:\n```bash\ncitadel-predict-mcp --help\n```\n\n---\n\n## Quickstart: One-Command Auto-Configuration (Recommended)\n\nTo automatically configure **both** Claude Desktop and Claude Code on Windows, macOS, or Linux with zero manual JSON editing:\n\n```bash\n# Run from repository root with your active Python environment:\npython scripts/configure_mcp.py\n\n# Or pass parameters non-interactively:\npython scripts/configure_mcp.py -…","publisher":{"name":"Citadel Predict Team","url":null},"homepage":null,"repository":null,"version":"0.2.0","license":"MIT","protocols":["mcp"],"tags":["agent-cost","citadel-predict","claude","claude-code","claude-desktop","llm-budget","mcp","model-context-protocol","token-estimation"],"pricing":null,"endpoints":[{"url":"pypi:citadel-predict-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"knowledge.reasoning","name":"Reasoning & Planning","confidence":0.836,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev","knowledge"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"citadel-predict-mcp","registry":"pypi","observedAt":"2026-11-09T01:27:37.711Z","publishedAt":"2026-09-07T12:06:35.040579Z","latestVersion":"0.2.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"citadel-predict-mcp","url":"https://pypi.org/project/citadel-predict-mcp/","firstSeenAt":"2026-09-09T11:30:40.896Z","fetchedAt":"2026-11-09T01:26:52.258Z","normalizedAt":"2026-11-09T01:26:52.258Z"}]},"firstSeenAt":"2026-09-09T11:30:40.896Z","updatedAt":"2026-11-09T01:27:37.711Z"}