chainlink-sentinel
Enables monitoring of Chainlink price feeds on the BNB Chain to detect oracle staleness, stablecoin depegs, and market anomalies.
Provides real-time cross-chain oracle monitoring, anomaly detection, and risk intelligence by reading data feeds across multiple EVM networks.
Enables monitoring of Chainlink price feeds on the Ethereum network to detect oracle staleness, stablecoin depegs, and market anomalies.
Enables monitoring of Chainlink price feeds on the Polygon network to detect oracle staleness, stablecoin depegs, and market anomalies.
Chainlink Sentinel
AI-powered cross-chain risk monitor using Chainlink Data Feeds. Reads on-chain oracle data across 6 EVM chains, detects anomalies in real-time, and generates actionable risk intelligence — all as MCP tools for AI agents.
What it does
Cross-chain oracle scanning: Reads 30+ Chainlink price feeds across Ethereum, Polygon, Arbitrum, Base, Avalanche, and BNB Chain
Anomaly detection: Identifies stale oracles, stablecoin depegs, cross-chain price deviations, and potential oracle attacks
Risk reports: Generates comprehensive risk assessments with severity scoring, chain health metrics, and recommendations
Zero config: No API keys needed. Uses Chainlink's on-chain data via public RPCs
Built with Chainlink
Chainlink Product | Usage |
Data Feeds | Primary data source — reads AggregatorV3Interface across all chains |
CRE | Cross-chain runtime for multi-chain oracle monitoring |
CCIP | Cross-chain message passing for alert propagation (planned) |
MCP Tools (6)
Tool | Description |
| Full cross-chain scan — all feeds, all chains, all anomalies |
| Scan a specific chain (ethereum, polygon, arbitrum, etc.) |
| Read a single Chainlink price feed |
| Monitor USDC/USDT/DAI pegs across all chains |
| Generate AI risk report with recommendations |
| Compare a price pair across chains (detect deviations) |
Quick Start
# Install
npm install
# Build
npm run build
# Run as MCP server
npm startUse with Claude Code
Add to ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"chainlink-sentinel": {
"command": "node",
"args": ["/path/to/chainlink-sentinel/dist/index.js"]
}
}
}Then ask Claude: "Run a cross-chain sentinel scan" or "Check stablecoin pegs"
Architecture
┌─────────────────────────────────────────────────────┐
│ AI Agent (Claude/Cursor) │
│ via MCP Protocol │
└─────────────────────┬───────────────────────────────┘
│
┌─────────────────────▼───────────────────────────────┐
│ Chainlink Sentinel MCP Server │
│ ┌──────────┐ ┌──────────────┐ ┌────────────────┐ │
│ │ Feed │ │ Anomaly │ │ Risk Analysis │ │
│ │ Reader │ │ Detector │ │ Engine │ │
│ └────┬─────┘ └──────────────┘ └────────────────┘ │
└───────┼─────────────────────────────────────────────┘
│
┌───────▼─────────────────────────────────────────────┐
│ Chainlink Data Feeds (On-Chain) │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐ │
│ │Ethereum │ │Polygon │ │Arbitrum │ │Base/Avax │ │
│ │9 feeds │ │5 feeds │ │4 feeds │ │/BNB │ │
│ └─────────┘ └─────────┘ └─────────┘ └──────────┘ │
└─────────────────────────────────────────────────────┘Anomaly Types
Type | Severity Logic | Description |
Stale Oracle | >1h major, >2h minor | Oracle hasn't updated within expected heartbeat |
Depeg | >0.5% warning, >5% critical | Stablecoin deviating from $1.00 peg |
Cross-chain Deviation | >2% medium, >10% critical | Same pair showing different prices on different chains |
Flash Crash | Price drop >20% in 1 round | Sudden price movement suggesting manipulation |
Feeds Supported (30+)
BTC/USD, ETH/USD, SOL/USD, LINK/USD, USDC/USD, USDT/USD, DAI/USD, AAVE/USD, UNI/USD, MATIC/USD, ARB/USD, AVAX/USD, BNB/USD — across 6 chains.
Convergence Hackathon
Track: CRE & AI / Risk & Compliance
Why Chainlink Sentinel matters:
DeFi protocols need real-time oracle health monitoring
Cross-chain deviations signal arbitrage or attacks
Stablecoin depeg detection prevents cascading liquidations
AI agents can autonomously act on risk intelligence
Differentiation:
First MCP-native Chainlink monitoring tool
Works with any AI agent (Claude, Cursor, Windsurf)
Zero API keys — reads directly from on-chain Chainlink contracts
Cross-chain by default — not single-chain monitoring
License
MIT
Author
Elrom Eved El Elyon — @opencllaw
Available Tools
6 toolssentinel_chainB
Scan all Chainlink price feeds on a specific chain
Inputs: chain (required).
sentinel_compareA
Compare a price pair across all available chains to detect cross-chain deviations
Inputs: pair (required).
sentinel_feedC
Read a single Chainlink price feed (e.g., BTC/USD on ethereum)
Inputs: chain (required), pair (required).
sentinel_risk_reportB
Generate a comprehensive AI risk report with cross-chain health, anomaly analysis, and recommendations.
Inputs: no named parameters.
sentinel_scanA
Run a full cross-chain Chainlink oracle scan across 6+ EVM chains. Returns all feed prices, staleness, and detected anomalies.
Inputs: no named parameters.
sentinel_stablecoinsA
Monitor stablecoin pegs (USDC, USDT, DAI) across all chains. Detects depegs and deviations.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes, but sentinel_chain and sentinel_scan could cause confusion as both involve scanning across chains. sentinel_chain scans all feeds on a specific chain, while sentinel_scan does a full cross-chain scan across multiple chains, but the naming overlap may lead to misselection without careful reading of descriptions.
All tools follow a consistent 'sentinel_' prefix with descriptive suffixes, using snake_case uniformly. The naming pattern is predictable and clear, making it easy for agents to understand the tool set's structure and purpose.
With 6 tools, this server is well-scoped for monitoring Chainlink oracles and stablecoins. Each tool serves a specific function in the domain, from single-feed reads to cross-chain analysis, without being overly sparse or bloated.
The tool set covers key aspects of Chainlink oracle monitoring, including single feeds, cross-chain comparisons, risk reporting, and stablecoin tracking. A minor gap exists in lacking tools for historical data analysis or alert configuration, but core monitoring workflows are well-supported.
Related MCP Connectors
Chainlink tools over MCP: CCIP cross-chain, data feeds, data streams, VRF, proof of reserve.
23-in-1 MCP server: EVM tx simulator, funding rate arb, macro radar, swap calldata & security.
Ethereum tools over MCP: Chainlink feeds, ENS, ERC-8004 agents, EAS attestations, transactions.
MCP server for Renzo protocol data, including chains, vaults, operators, and ezETH metrics.