Skip to main content
Glama
OathScore

OathScore

by moxiespirit

OathScore

Every API makes promises. OathScore checks the receipts.

The trust layer for AI agents. Two products:

  1. /now — A single endpoint returning the current state of the world for trading agents. Exchange status, volatility, events, regime, data health — one call.

  2. 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

Related 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

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

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 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 tools
check_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

    A4/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: health check, API comparison, alerts, events, exchanges, combined state, score retrieval, and volatility. No overlapping functionality.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Connects 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.
      13
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Financial 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.
      31
      9 npm
      9
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Live 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.
      2
      8
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides 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 PyPI
      MIT