README.md
The trust layer for AI agents.
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,alphavantage
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 |
|---|---|
get_now |
Current world state: exchanges, volatility, events, data health |
get_exchanges |
Open/close status for 7 exchanges with next transition times |
get_volatility |
VIX, VIX9D, VIX3M, VVIX, SKEW, term structure |
get_events |
Next event, FOMC/CPI countdowns, week high-impact count |
get_score |
OathScore rating for a specific API (0-100 composite + grade) |
compare_apis |
Side-by-side comparison of two or more data APIs |
get_alerts |
Active degradation alerts for monitored APIs |
check_health |
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 | /now Calls |
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 endpoints
Integration 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 LangCha
Tools (8)
get_nowCurrent world state: exchanges, volatility, events, data healthget_exchangesOpen/close status for 7 exchanges with next transition timesget_volatilityVIX, VIX9D, VIX3M, VVIX, SKEW, term structureget_eventsNext event, FOMC/CPI countdowns, week high-impact countget_scoreOathScore rating for a specific API (0-100 composite + grade)compare_apisSide-by-side comparison of two or more data APIsget_alertsActive degradation alerts for monitored APIscheck_healthService health and data freshnessConfiguration
claude_desktop_config.json
{"mcpServers": {"oathscore": {"command": "python", "args": ["-m", "oathscore_mcp"]}}}Try it
→What is the current market volatility and are there any upcoming high-impact economic events?
→Check the status of the major exchanges and tell me if any are currently closed.
→Compare the reliability scores of Polygon.io and Alpha Vantage.
→Are there any active degradation alerts for the data APIs I am currently using?
→What is the current OathScore rating for Curistat?