Orion Agent Kit
Celestia network intelligence for AI agents. An MCP server over Orion's daily analysis: anomaly signals, network verdicts, staking & DA metrics, live namespace and validator drill-downs — each figure linked back to the source it came from.
MCP Celestia Node License: Apache-2.0
https://orionlabsone.cc/mcp
What this is
Orion watches Celestia mainnet continuously and publishes a daily machine-written brief: what moved, what drifted from baseline, and why it matters. This kit exposes that analysis to AI agents over the Model Context Protocol.
Think of it as an analysis layer for the Celestia agent ecosystem. It sits alongside knowledge bases (which answer "what is CIP-21?") and raw-data or transaction kits (which list blobs or build a delegate tx). Orion answers a different question: what is happening on the network right now, is it normal, and how did we get here?
Every number the server returns carries a provenance link to the Celenium or Celestia LCD endpoint it was read from, so the agent can cite its sources — and so can you. The server is read-only: no wallets, keys, or transactions anywhere in it.
Tools
Today & anomalies
| Tool | Question it answers |
|---|---|
get_daily_brief | What's happening on Celestia today? (set include_narrative for Orion's written prose) |
get_signals | Any anomalies (info / notable / critical) today or on date X? |
get_network_state | Current height, DA volume, validators, staking ratios, Nakamoto coefficient, TIA price |
Trends & history
| Tool | Question it answers |
|---|---|
get_trends | What changed since yesterday / last week? (day- and week-over-week deltas) |
get_metric_history | Chart one metric (fees, blobs, price, staking ratio…) over N days |
list_reports | What daily reports exist in the archive? |
get_report | Full report for a given date |
search_reports | When did the archive last mention "eclipse" or "block time"? |
Live drill-down (straight from Celenium)
| Tool | Question it answers |
|---|---|
get_top_namespaces | Which rollups post the most data to Celestia right now? |
get_namespace | Detail for one namespace: size, blob count, last activity |
get_top_validators | Largest validators by stake — moniker, commission, jailed status |
Resources & prompts
Beyond tools, the server exposes MCP resources an agent can read or subscribe to:
orion://latest— the most recent daily reportorion://reports— the archive indexorion://report/{date}— any archived report by date
…and ready-made prompts to guide an agent:
daily_celestia_briefing— produce a grounded, source-cited daily briefingrollup_da_check— survey who dominates blobspace and the current DA cost context
What counts as a signal
Orion's detectors are event-driven, not state-driven — a persistently dominant namespace or a steady utilization day produces no signal, so what you see is what actually changed:
- DA utilization & fees — per-block volume and fees over the last day vs the recent daily baseline
- Blob-volume z-score — statistical spikes/drops in data posted
- Namespace shift — only when the DA leader changes or its share moves materially
- Staking & concentration — bonded-ratio moves, Nakamoto-coefficient changes, new jailings
- Market & protocol — notable TIA price moves, active governance proposals, new celestia-app releases
Each daily brief is written by an LLM narrator and passes an automated citation check — every number in the prose is verified against the structured data before publishing.
Quick start — hosted endpoint (no install)
The MCP server runs at https://orionlabsone.cc/mcp.
Claude Code
claude mcp add --transport http orion https://orionlabsone.cc/mcp
Cursor — add to .cursor/mcp.json (already included if you cloned this repo):
{ "mcpServers": { "orion": { "url": "https://orionlabsone.cc/mcp" } } }
VS Code — add to .vscode/mcp.json:
{ "servers": { "orion": { "type": "http", "url": "https://orionlabsone.cc/mcp" } } }
Claude Desktop / Codex / Windsurf / Cline / any stdio-only client — bridge with mcp-remote:
{
"mcpServers": {
"orion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://orionlabsone.cc/mcp"]
}
}
}
Per-client walkthroughs: Claude Code · Claude Desktop · Cursor · Codex · VS Code
Quick start — clone & chat
git clone https://github.com/orioninfra/orion-agent-kit
cd orion-agent-kit
npm install
claude # Claude Code picks up .mcp.json automatically
Then just ask:
"Any anomalies on Celestia today?" · "What changed on Celestia since yesterday?" · "Which rollups post the most data right now?" · "How concentrated is the validator set?" · "When did the archive last flag block time?"
The bundled /brief and /signals commands wrap the two most common queries.
Run the server yourself
npm install
npm run start # Streamable HTTP on 127.0.0.1:8791/mcp
npm run start:stdio # stdio transport (for local MCP clients)
npm run smoke # end-to-end check of the tools against the live API
npm run typecheck # type-check the sources
Environment: PORT (default 8791), HOST (default 127.0.0.1), ORION_API_BASE (default https://orionlabsone.cc), CELENIUM_BASE (default https://api-mainnet.celenium.io/v1, used by the drill-down tools).
REST, without MCP
The underlying API is plain JSON, usable directly or via function calling with the OpenAPI spec:
| Endpoint | Returns |
|---|---|
GET /api/latest | today's full report |
GET /api/reports | archive index |
GET /api/reports/{date} | full report for a date |
GET /api/rss | the brief as an RSS feed |
How it fits together
AI agent (Claude / GPT / any MCP client)
│ MCP — read-only analysis tools, resources & prompts
▼
orion-agent-kit ──► Orion daily analysis (orionlabsone.cc/api)
│ │ every figure linked to its source
│ ▼
│ Celestia LCD · market data
└──────────► Celenium API (live namespace & validator drill-down)
License
Apache-2.0, Copyright 2026 Orion Labs. Questions, ideas, or a tool you wish existed: open an issue.