OathScore
Provides tools for independent, continuous verification of Polygon.io's API accuracy, uptime, and freshness, enabling AI agents to assess data reliability through composite scores and health alerts.
OathScore
Every API makes promises. OathScore checks the receipts.
The trust layer for AI agents. Two products:
/now— A single endpoint returning the current state of the world for trading agents. Exchange status, volatility, events, regime, data health — one call.OathScore Ratings — Independent, continuous verification of data API accuracy, uptime, freshness, and reliability. The credit bureau for data APIs.
For AI Agents
# What's happening right now?
curl https://api.oathscore.dev/now
# Should I trust this data source?
curl https://api.oathscore.dev/score/curistat
# Compare two sources
curl https://api.oathscore.dev/compare?apis=curistat,alphavantageRelated MCP server: fathom-fyi
For MCP-Compatible Agents (Claude Code, Cursor, etc.)
{
"mcpServers": {
"oathscore": {
"command": "python",
"args": ["-m", "oathscore_mcp"]
}
}
}Requires: pip install httpx mcp[cli] and clone this repo.
MCP Tools
Tool | Description |
| Current world state: exchanges, volatility, events, data health |
| Open/close status for 7 exchanges with next transition times |
| VIX, VIX9D, VIX3M, VVIX, SKEW, term structure |
| Next event, FOMC/CPI countdowns, week high-impact count |
| OathScore rating for a specific API (0-100 composite + grade) |
| Side-by-side comparison of two or more data APIs |
| Active degradation alerts for monitored APIs |
| Service health and data freshness |
What OathScore Monitors
For each rated API:
Metric | Weight | How Measured |
Accuracy | 35% | Compare forecasts/claims to actual outcomes daily |
Uptime | 20% | Synthetic monitoring every 60 seconds |
Freshness | 15% | Is "real-time" actually real-time? |
Latency | 15% | P50/P95/P99 from multiple regions |
Schema stability | 5% | Detect breaking changes |
Documentation | 5% | OpenAPI spec, llms.txt, examples |
Trust signals | 5% | Published accuracy data, response signing |
Rated APIs (v1)
API | Category | Score | Status |
Curistat | Futures volatility | -- | Monitoring |
Alpha Vantage | Equities/macro | -- | Monitoring |
Polygon.io | Market data | -- | Monitoring |
Finnhub | Multi-asset | -- | Monitoring |
Twelve Data | Market data | -- | Monitoring |
EODHD | Historical data | -- | Monitoring |
Financial Modeling Prep | Fundamentals | -- | Monitoring |
Scores populate after 30 days of monitoring data.
Machine-Readable Discovery
/llms.txt— Agent-readable product description/llms-full.txt— Complete endpoint documentation/.well-known/ai-plugin.json— ChatGPT plugin manifest/openapi.json— OpenAPI 3.0.3 spec/docs— Interactive Swagger UI
Pricing
Tier |
| Score Queries | Price |
Free | 10/day | 5/day | $0 |
Founding (first 50) | 5,000/day | 2,500/day | $9/mo (lifetime) |
Pro | 10,000/day | 5,000/day | $29/mo |
Enterprise | 100,000/day | 50,000/day | $99/mo |
Pay-per-request (x402) | Unlimited | Unlimited | $0.001-0.005/call |
x402 micropayments: No signup needed. Agents pay per request with USDC stablecoins via the x402 protocol. When rate limited, the API returns 402 Payment Required with payment instructions.
API audits: Independent 7-day quality audit of your API — $299-499. Contact us.
Architecture
[Monitoring Service - Railway $5/mo]
Every 60s: ping all rated APIs (uptime, latency)
Every 5m: check data freshness
Every 1h: record forecast snapshots
Every 24h: compare forecasts to actuals (accuracy)
Store: Supabase (free tier)
[/now Endpoint - Cloudflare Workers $0/mo]
Every 60s: fetch VIX, compute exchange status, read events
Serve: cached JSON, max-age=30, ETag support
[Scoring Engine - Cloudflare Workers $0/mo]
Every 5m: recompute composite scores from raw metrics
Serve: /score, /compare, /alerts endpointsIntegration Examples
CrewAI
from crewai import Agent, Task
from crewai_tools import MCPTool
# Connect to OathScore MCP
oathscore = MCPTool(server_command="python -m oathscore_mcp")
analyst = Agent(
role="Market Analyst",
tools=[oathscore],
goal="Assess current market conditions before trading"
)
task = Task(
description="Check if markets are open and get current volatility regime",
agent=analyst
)LangChain
from langchain_mcp import MCPToolkit
toolkit = MCPToolkit(server_command="python -m oathscore_mcp")
tools = toolkit.get_tools()
# Use in any LangChain agent
from langchain.agents import initialize_agent
agent = initialize_agent(tools, llm, agent="zero-shot-react-description")
agent.run("What's the current VIX level and are US markets open?")Direct HTTP (any language)
import httpx
# World state in one call
now = httpx.get("https://api.oathscore.dev/now").json()
print(f"VIX: {now['volatility']['vix']}")
print(f"CME: {'OPEN' if now['exchanges']['CME']['is_open'] else 'CLOSED'}")
print(f"Next event: {now['events']['next_event']}")
# API quality check before committing to a data source
score = httpx.get("https://api.oathscore.dev/score/polygon").json()
if score.get("composite_score", 0) < 70:
print("Warning: data source quality below threshold")Claude Desktop / Claude Code
Add to your MCP config (~/.claude/mcp.json or Claude Desktop settings):
{
"mcpServers": {
"oathscore": {
"command": "python",
"args": ["-m", "oathscore_mcp"]
}
}
}Then ask Claude: "What's the current market state?" or "How reliable is Alpha Vantage?"
If this is useful, star the repo — it helps others find it.
License
Proprietary. All rights reserved.
Available Tools
8 toolscheck_healthA
Check OathScore service health and data freshness.
Inputs: no named parameters. Returns: result
compare_apisA
Compare quality scores of two or more APIs side-by-side. Pass comma-separated names, e.g. 'polygon,twelvedata'.
Inputs: apis (required). Returns: result
get_alertsA
Get active degradation alerts for monitored APIs. Shows uptime drops, high latency, and schema changes.
Inputs: no named parameters. Returns: result
get_eventsA
Get economic event countdowns: next event, today remaining, week high-impact count, days until FOMC and CPI.
Inputs: no named parameters. Returns: result
get_exchangesA
Get open/close status for CME, NYSE, NASDAQ, LSE, EUREX, TSE, HKEX with next transition times.
Inputs: no named parameters. Returns: result
get_nowA
Get current world state: exchange status, volatility (VIX/VVIX/SKEW/term structure), economic event countdowns, and data health. One call replaces 4-6 separate API calls.
Inputs: no named parameters. Returns: result
get_scoreA
Get OathScore quality rating for a specific API. Available APIs: alphavantage, polygon, finnhub, twelvedata, eodhd, fmp, fred, coingecko, alpaca, yfinance. Returns composite score (0-100), letter grade, and component breakdown.
Inputs: api_name (required). Returns: result
get_volatilityA
Get current volatility readings: VIX, VIX9D, VIX3M, VVIX, SKEW, and term structure (contango/backwardation/flat).
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose: health check, API comparison, alerts, events, exchanges, combined state, score retrieval, and volatility. No overlapping functionality.
All tool names follow a consistent verb_noun pattern with snake_case (e.g., get_score, check_health). Conventions are uniform across all 8 tools.
With 8 tools, the server is well-scoped for monitoring API quality and financial market data. Each tool provides distinct value without being overly numerous or sparse.
Core operations are covered: score retrieval, comparison, health, alerts, volatility, exchanges, events, and a combined view. Minor gaps like historical trends or API management are absent but not critical for the stated purpose.
Maintenance
Related MCP Connectors
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.
Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.
Market intelligence for AI agents. Real-time data, cross-market analysis, and regime detection.
Related MCP Servers
- AlicenseAqualityCmaintenanceConnects AI agents to real-time crypto market data, covering market health scores, derivatives, ETF flows, and BTC cycle indicators. It provides 13 specialized tools for structured market analysis, sentiment tracking, and monitoring macro-economic indicators.131MIT
- AlicenseAqualityDmaintenanceFinancial intelligence for AI agents. 31 tools across 8 data sources — regime, derivatives, stablecoin flows, momentum, volatility, macro, DeFi, weather patterns, political cycles, seasonality. The context layer between your agent and a bad trade.319 npm9MIT
- AlicenseAqualityDmaintenanceLive market data for AI agents. 8 tools: real-time crypto prices, OHLCV candles, order books, market cap rankings, trending coins, technical analysis (RSI/SMA/z-score), asset comparison, and Fear & Greed index. Zero API keys, zero dependencies.281MIT

oneqaz-trading-mcpofficial
AlicenseNot gradedqualityBmaintenanceProvides AI agents with real-time financial market intelligence including regime detection, adaptive signals, macro context chains, and cross-market analysis for crypto, US, and Korean stocks.91 PyPIMIT