# Seneschal Data MCP server

Live DeFi liquidation, Ethereum builder & Monero/Zcash data over MCP. Free, no key; x402 premium.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-rotwang9000-seneschal-data
- Repository: https://github.com/Rotwang9000/seneschal-data-api
- Website: https://seneschal.space

## Install
- Endpoint: https://mcp.seneschal.space/
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.seneschal.space/

## Tools
- seneschal_health (Service health) - Returns table sizes and data-source freshness timestamps for the Seneschal Data backend. Endpoint: https://mcp.seneschal.space/
- seneschal_list_at_risk_borrowers (List at-risk borrowers) - Current snapshot of borrowers across Aave, Morpho, and Spark whose health factor sits below `max_hf`, sorted ascending. Use `min_debt_usd` to ignore dust positions. Endpoint: https://mcp.seneschal.space/
- seneschal_list_borrowers (List borrowers (generic)) - Generic discovery surface over the borrower snapshot table. Like `seneschal_list_at_risk_borrowers` but with both lower and upper HF bounds, optional max-debt cap, configurable sort field/direction, and offset-based pagination. Use this to walk the catalogue without knowing borrower addresses in advance. Endpoint: https://mcp.seneschal.space/
- seneschal_recent_liquidations (Recent liquidations) - Liquidations observed in the recent past, including both ones won by other liquidators (`outcome=won_by_other`) and ones we ourselves landed (`outcome=we_landed`). Sorted by timestamp descending. Endpoint: https://mcp.seneschal.space/
- seneschal_get_borrower (Get borrower snapshot) - Returns the latest known state of `address` across every protocol where we have data (Aave, Morpho, Spark). Pass the EOA / contract address as a 0x-prefixed 20-byte hex string. Endpoint: https://mcp.seneschal.space/
- seneschal_get_borrower_history (Get borrower history) - Returns a time series of (timestamp, health_factor, collateral_usd, debt_usd) observations for `address` on `protocol`. Granularity defaults to raw observations; use `hour` or `day` for chart-friendly buckets. Endpoint: https://mcp.seneschal.space/
- seneschal_builder_leaderboard (Builder leaderboard) - Slot-by-slot ground-truth share of Ethereum mainnet block builders observed by Seneschal's shadow recorder, with total MEV captured per builder in the window. Cached for 60s. Endpoint: https://mcp.seneschal.space/
- seneschal_stats_overview (Public stats overview) - Aggregate snapshot powering the public stats dashboard at stats.seneschal.space: total positions tracked, debt under watch, HF distribution histogram, top-10 at-risk borrowers, 30-day liquidations-per-day series, builder market share for 24h/7d/30d windows, and 10 most recent on-chain liquidations. One call returns everything needed to render the dashboard. Endpoint: https://mcp.seneschal.space/
- seneschal_paywall_info (Paywall / x402 metadata) - Returns the protocol, network, recipient address, and per-call price for every gated endpoint on this data backend. Free to call. Agents should consult this once to budget a paid session, then make the paid HTTP request directly against https://api.seneschal.space/v1/premium/opportunities with an x402 PAYMENT-SIGNATURE header (see https://docs.x402.org). Endpoint: https://mcp.seneschal.space/
- seneschal_premium_opportunities (Premium opportunity feed (paid)) - Top at-risk borrowers across Aave + Morpho + Spark, annotated with realised 7d market intel (top liquidators, win rate, our own attempt outcomes) and ranked by expected liquidation value. Behind an x402 paywall: free agents see a paywall stub describing how to pay; paying agents fetch the full feed at https://api.seneschal.space/v1/premium/opportunities. Use seneschal_paywall_info to inspect the price/network/recipient before opening a session. Endpoint: https://mcp.seneschal.space/
- seneschal_premium_builder_stats (Premium per-builder bid distribution (paid)) - Per-builder bid distribution (p25/median/p75/p90/p99/max ETH) and a 24-element hourly slot histogram over a configurable window. Sourced from the Seneschal shadow recorder so it covers every observed slot, not just landed blocks. Behind an x402 paywall at the REST surface; this MCP tool serves the data directly to authenticated agents. Endpoint: https://mcp.seneschal.space/
- seneschal_q (Penny Oracle: atomic single-fact endpoints (DeFi + privacy chains)) - Atomic single-fact endpoints designed for tight agent loops. Each answers ONE yes/no or one number — sub-50ms, flat $0.001/call at the REST surface. Two families: (1) DeFi facts sourced from our SQLite + shadow-blocks recorder (liquidatable, at-risk-count, recent-liquidations, top-builder, builder-share, builder-bid, cheapest-flashloan, data-freshness); (2) privacy-chain facts sourced from Seneschal-operated full nodes — Monero (xmr/height, xmr/mempool, xmr/fee, xmr/last-block) and Zcash (zec/height, zec/mempool, zec/last-block). Consult /v1/q for per-question input lists and live chain availability. Endpoint: https://mcp.seneschal.space/
- seneschal_private_watch_info (Private watch — service metadata) - Returns the current price, supported chains, NFPT upstream health, and security notes for the view-key payment-monitoring service. Free to call. Endpoint: https://mcp.seneschal.space/
- seneschal_private_watch_create (Create a Monero/Zcash payment watch (paid via x402 at REST)) - Subscribe a Monero or Zcash address to view-key-based payment monitoring. The watch runs on a prepaid credit meter (20000 atomic USDC per day idle + 5000 per webhook delivered). Creation at the REST surface (POST /v1/private/watch) is paywalled at $0.10 via x402 and seeds the watch with $0.10 of credit. Receiver gets HMAC-signed webhooks plus a 'credit' block on every body; a 'low_credit' warning fires once before the meter expires. Top up via /v1/private/topup, topup-1, or topup-5. View keys are AES-256-GCM encrypted at rest. Endpoint: https://mcp.seneschal.space/
- seneschal_private_watch_topup (Top up an existing watch (paid via x402 at REST)) - Add prepaid credit to an existing Private Watch. Three tiers — $0.10 (default), $1.00, and $5.00 — each settling at the matching REST path (/v1/private/topup, /topup-1, /topup-5). Credit is in atomic USDC ($0.02/day idle, $0.005/call). This tool returns the URL the agent should POST to with its x402 client; it does NOT settle payment itself. Endpoint: https://mcp.seneschal.space/
- seneschal_private_watch_historical (One-off historical scan (paid via x402 at REST)) - Return all spendable + spent notes for a view key without setting up a watch. The view key never touches our SQLite — it flows through to NFPT in memory only. Use this when you want to reconcile a wallet at a point in time. Priced at $0.50 / call at the REST surface. Endpoint: https://mcp.seneschal.space/
- seneschal_private_watch_derive_viewkey (Derive a Zcash UFVK from a BIP-39 mnemonic (FREE, rate-limited)) - Hands a 12- or 24-word seed phrase to NFPT's orchard-scanner CLI, returns the matching UFVK. FREE but rate-limited to 6/minute/IP. Be loud about the security trade-off: the phrase transits our server (no logging, no persistence) but a network observer between you and us would see the bytes. Offline derivation with the orchard-scanner binary on a trusted host is the safer alternative — see https://docs.seneschal.space/derive-locally. A UFVK is read-only; it cannot spend funds. Endpoint: https://mcp.seneschal.space/
- seneschal_flashloan_providers (Flash loan provider catalogue) - Curated catalogue of Ethereum mainnet flash-loan providers (Aave V3, Balancer V2, Morpho Blue, Uniswap V3, FlashBank) with current fee in basis points, contract addresses, qualitative liquidity notes, and per-provider caveats. Helpful for searcher agents picking the cheapest viable provider for a liquidation or arbitrage strategy. The catalogue is editorially open: filter by chain, max fee, or multi-asset support. Endpoint: https://mcp.seneschal.space/

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.Rotwang9000
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 28, 2026
- Source: https://registry.modelcontextprotocol.io