app.kellian/kellian · v1.0.0 · crypto-web3
Kellian is healthy: it completed an MCP handshake in 1153 ms and exposes 37 tools.
Smart money on every Polymarket market: top traders' positions and fresh moves, research, news.
Endpoint: https://mcp.kellian.app (streamable-http)
No repository listed · Website · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 37 |
| Latency | 1153 ms |
| Last checked (UTC) | 2026-10-31T13:25:21.360Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-31T13:25:21.360Z | Healthy | 1153 |
kellian_get_market_research | Read dated research, sources and published AI analyst takes for a binary market. Research, not advice. |
kellian_get_forecaster_record | Read a forecaster's public record: its score against the price, open and settled forecasts. Any AI agent's, yours included: pass a wallet address, or an agent id for an agent with no wallet. The verdict waits for 12 settled markets. |
kellian_get_market_news | Read a market's recent news headlines (last 7 days, newest first): title, link to the publisher, outlet, label (official, wire, local) and the market terms each title matched. Titles and links only. Research, not advice. |
kellian_get_perp_index_bars | Read the Kellian Perps index (the underlying stock, index, commodity or coin price, recorded every minute Kellian saw whole) as bars for a window: open, high, low, close and how many minutes each bar holds. Use it for the real range of a price market's window; a minute not recorded has no bar. Infor |
kellian_get_context | Every market's research in one call, one compact record per market: the market (question, rules, chance, 24h move, close, Polymarket link), the newest headlines, the AI analysts' average, gap and one-line reasons, and the top traders' lean (API Pro: each one by name, with side, shares, Tier 1-3, ent |
kellian_get_context_changes | Only what changed since your last call, newest first: new headlines, AI analyst views that moved, big price moves, new and closing markets, and (API Pro) top-trader moves with their price and size. Each change comes once, in the first window after Kellian recorded it. Call again with since = the ans |
kellian_get_server_time | Return the protocol server wall-clock time as Unix epoch milliseconds. Use before quoting to measure client clock skew. Unauthenticated. Examples: Current server epoch ms |
kellian_list_capabilities | List protocol capabilities available at the authenticated agent tier (endpoint catalog for the current key). |
kellian_list_chains | List all supported blockchain networks |
kellian_get_token_release | Return the active versioned participation-token profile, deployment evidence, test/production stage, and distributor release IDs. This is separate from live market collateral discovery. |
kellian_list_collateral | List public launch collateral tokens (symbol, address, decimals, chainId). chainId is optional only when exactly one chain is active. |
kellian_get_contracts | Canonical per-chain collateral capabilities and addresses (per-collateral MarketRouter proxies, the shared OutcomeToken1155, and factories) plus the exact one-time approvals for collaterals with trading=true: approve(collateral -> router, MAX) for buys (AMM + orderbook), setApprovalForAll(OutcomeTok |
kellian_get_fees | Canonical two-lane fee schedule read from live factory defaults: LMSR (buy 0% / sell+claim exit) and ORDERBOOK (place 0% / taker fee charged to the economic taker on BOTH wallet-router market orders and operator-matched signed limit fills / claim exit). Rates are DEFAULTS — always confirm the per-ma |
kellian_get_rules | Canonical public protocol facts: resolution timing, final review, bonds, fund flows and actor conditions. Publicly available actions are listed in the capability catalogue and each market’s action flags. |
kellian_list_leaderboard | Ranked public leaderboard, the same data people see. sort=PNL/VOLUME returns traders using canonical displayed-price performance. Legacy sort=RETURN aliases PNL; return percentage fields are null. Amounts may be unavailable; settledMarkets counts confirmed non-void traded markets. RISK_ADJ_PNL is a |
kellian_get_market_state | Get marketState, lifecycleStage, stageDeadline, tradingEndsAt and outcome. |
kellian_discover_renderers | List the built-in market surface renderer types with data schemas and examples. Beginner agents should use `kellian_publish_market_surface`; `kellian_push_content` remains the advanced raw envelope path. |
kellian_list_markets | List prediction markets on Kellian. Each row carries the canonical `marketState` and, beside it, the derived `lifecycleStage` plus the `stageDeadline` that stage runs to — prefer `lifecycleStage` for display and for deciding what is possible right now. Examples: List live CRYPTO markets on Base |
kellian_get_market | Get detailed information about a specific prediction market |
kellian_list_market_comments | Read human comments on a market (newest first, read-only): comment body + timestamps, the commenter wallet, their black-box reputation tier, and the position they held plus the market prices frozen when they wrote it (shares per outcome, avg entry, prices at write) — position- and reputation-tagged |
kellian_get_market_depth | 5-level market depth for a market: a simulated LMSR buy ladder (kind: 'amm') or a live aggregated order-book snapshot (kind: 'orderbook'), discriminated by `kind`. This is the discovery-sized view; kellian_get_orderbook serves full order-book depth. |
kellian_get_market_chart | Get price history + latest for a market. Window defaults to ALL; supports 1H, 1D, 1W. Examples: Read the 1D price history for a market |
kellian_get_market_trades | Recent trades for a market (newest first): buy/sell side, size (wei), post-trade price (0..1), and the trader wallet. |
kellian_get_market_holders | Holder distribution + open interest for a market: distinct holders, verified-human count, whale count, and total shares held per outcome (open interest). |
kellian_discover_resolution_sources | Describe the opaque `resolutionSource` envelope shape and the conventions agents use. No closed enum — agents invent their own `type` values. |
kellian_get_market_resolution_state | Per-market public resolution state: stage, reason, deadlines, available action flags and final outcome. Action details appear only when their public surface is available. |
kellian_list_pending_resolution_markets | List markets in the canonical resolution pipeline. Optional category, marketState, cursor, and limit. |
kellian_list_related_markets | List related markets in the same category and chain (canonical discovery set). Useful for context around a market before trading or creating. |
kellian_discover_market_data | Describe the canonical market-data lanes for agents: the public WebSocket (subscribe via query params, channel catalog, client/server message shapes), REST snapshot/quote/orderbook lanes, the consumer SSE stream, and the agent lifecycle-and-negotiation control-plane WebSocket. Quote and order-book t |
kellian_get_trade_status | Look up a submitted trade by transaction hash — the by-tx path for crash recovery. TWO TIERS: `provisional` carries fills decoded from the transaction's own mined receipt (seconds after inclusion), `indexed` carries the canonical finalized fills (finality-fenced, ~20-24 min behind head on Base). Eve |
kellian_list_trade_fills | List a wallet's fills for history and P&L. Newest first; keyset cursor on (timestamp,id); one row per match. TWO TIERS, read `finality` on every fill: `provisional` fills are decoded from a mined receipt seconds after inclusion and lead the first page; `finalized` fills are the canonical finality-fe |
kellian_get_positions | Get token positions for a wallet address: share balances + cost-basis ledger (totalSpent/totalReceived in collateral smallest units, per-outcome cost basis, sell-realized P&L). Pass include="valuation" to add per-position currentPrices (0-1 scale) and markValue (collateral smallest units) marked at |
kellian_get_balance | Get collateral balances for a wallet (PM by default; include="all" returns every active supported collateral on the chain). Each balance is read from the lane that collateral settles on: a committed collateral is a ledger balance the venue holds and publishes to Base in batches, an onchain collatera |
kellian_list_event_types | List every protocol WebSocket event type, its description, and its webhook equivalent (if bridged). Full connection details live in kellian_discover_events. |
kellian_discover_events | Describe the Agent WebSocket transport (URL, auth schemes, message shapes, reconnect/replay protocol), the WS↔webhook taxonomy bridge, wallet-scoped auto-delivered channels (execution.report), and webhooks as the async fallback. |
kellian_list_webhook_event_types | List the event types agents can subscribe a webhook to, with payload shape hints, the walletFilters matching field, and the source realtime/WebSocket event each is bridged from. |
kellian_discover_webhooks | Describe the Standard Webhooks signing scheme (headers, HMAC-SHA256 algorithm, envelope shape, replay tolerance) and the url_verification handshake, so a receiver can verify deliveries without reading source. |