ai-pricing-hub-mcp: Instructions file for Claude Code

CLAUDE.MD - AI Pricing Hub MCP App

Project: AI Pricing Hub MCP Framework: Skybridge (MCP App Framework) Repo: github.com/OptimNow/ai-pricing-hub-mcp (public, MIT) Deployed: https://optimtoken-mcp.optimnow.io/mcp (Fly.io app ai-pricing-hub-mcp, since 2026-10-07)

---

What This Project Does

An MCP (Model Context Protocol) app that provides AI/LLM model comparison, cost estimation, and cloud compute pricing tools as interactive widgets inside AI conversations (Claude, ChatGPT, VS Code, Goose). Built with Skybridge framework.

Origin: Business logic copied from the standalone web app cloud-sparkle-compare, which has since been renamed to OptimNow/ai-pricing-hub (private). The local checkout is still the cloud-sparkle-compare folder, and this file uses the old name throughout. It is deployed at optimtoken.optimnow.io, which is what this app reads its pricing from. The original app remains untouched.

---

Architecture

Framework:    Skybridge (MCP App Framework)
Language:     TypeScript
Build:        Vite + Skybridge plugins
UI:           React widgets (rendered via structuredContent)
Deployment:   Fly.io (app ai-pricing-hub-mcp, region cdg, scale-to-zero)
Transport:    Streamable HTTP at /mcp (https://optimtoken-mcp.optimnow.io/mcp)
Data:         optimtoken.optimnow.io API (source of truth)
              → direct OpenRouter (LLM only, uncorrected)
              → static fallback in data/pricing-data.ts

Data sources and the fallback chain

https://optimtoken.optimnow.io is the single source of truth for both LLM and compute pricing. It is the deployed face of cloud-sparkle-compare, and it is where pricing correctness lives: a committed price archive, a PRICE_OVERRIDES table verified against vendor pricing pages, and scripts/check-price-anomalies.mjs, which alarms on the ×0.5 / ×2.0 ratio breaks OpenRouter intermittently serves. This app has no archive and cannot build one, so it asks rather than re-derives.