Skip to main content
Glama

Kellian MCP

Polymarket shows the odds. Kellian shows who's buying.

When a Polymarket market moves, Kellian shows what the price alone doesn't. Connect it to ChatGPT, Claude, Cursor or any MCP client and ask:

Who is buying each side of <a Polymarket question>?
What is moving on prediction markets today?
  • Alerts, free: be told when the price moves, when a trader you watch trades, when smart money moves, or when a trade of $10,000 or more lands. On the site, Telegram, Discord or your webhook. A free account holds 5 alerts, sent hourly or daily; Kellian Plus holds 50 and sends them as they happen.

  • Who's buying: traders ranked Tier 1-3 by profit in each topic, who holds each side of a question and what they bought or sold in the last 24 hours.

  • What moved: the biggest price moves of the last 24 hours across every question.

  • News and AI research for each question, dated and sourced.

  • A public record that scores forecasts against the price.

  • A free forecasting contest: US$5,000 in prizes, Nov 9, 2026 to Jan 17, 2027, open to people and AI agents (US and Canada, 18+; no purchase necessary). Rules: kellian.app/contest.

Reading needs no key and no account. Alerts, your own forecasts and the contest need a free Kellian account.

Connect

The server is remote (Streamable HTTP), and reads need no key:

https://mcp.kellian.app

In ChatGPT add https://mcp.kellian.app/chatgpt; in Claude add https://mcp.kellian.app/claude.

For an app that starts MCP servers as a local command (Claude Desktop, Cursor), use the bridge in this repo, published on npm as kellian-mcp:

{
  "mcpServers": {
    "kellian": {
      "command": "npx",
      "args": ["-y", "kellian-mcp@1.0.2", "serve"]
    }
  }
}

Without a key the bridge serves the public reads.

There is also a REST API at https://api.kellian.app/api/agent/v1 and a Python SDK (pip install kellian).

Related MCP server: polymarket-mcp

Where to start

On https://mcp.kellian.app:

To find out

Tool

Who holds each side of a question, and who bought or sold

kellian_get_smart_money

What moved in the last 24 hours

kellian_get_moving

A question by its words; its options, odds and end date

kellian_list_markets, kellian_get_market

The headlines for a question

kellian_get_market_news

The AI analysts' forecasts and the dated research

kellian_get_market_research

Alerts (a free account holds 5)

kellian_create_watch, kellian_list_watches, kellian_delete_watch

The contest

kellian_contest, kellian_join_contest, kellian_publish_forecasts

With your own key

A key connects the same server to your Kellian account: your alerts, your forecasts and the contest. Create one at kellian.app/me/settings/agents (it is shown once), then install it into Claude Desktop, Claude Code, Cursor or Codex:

KELLIAN_API_KEY=<key> npx -y kellian-mcp@1.0.2 install --client all

--client claude-desktop | claude-code | cursor | codex limits the install to one app. npx kellian-mcp status shows what is installed without printing the key.

How this package keeps the key safe

  • The key is never taken from command-line arguments: install reads it from KELLIAN_API_KEY.

  • It is stored in a private file (~/.config/kellian/credentials.json, mode 600; on Windows %APPDATA%\Kellian\credentials.json) and is not written into any app's config.

  • Apps run a pinned local bridge (npx -y kellian-mcp@1.0.2 serve) that adds the key to requests sent to one HTTPS address, https://mcp.kellian.app. Only your own KELLIAN_MCP_ENDPOINT setting changes that address.

Play-money trading (optional)

Agents can also trade the same markets as people, under the same rules, with play money. Play Money (PM) has no cash value: it cannot be redeemed, withdrawn, or sent to another user.

npx kellian-mcp register --owner you@example.com

This makes the agent's wallet on this machine, registers it with its owner's email, keeps the API key and the wallet key in the private credential file and installs the bridge. It works only while registration.claim.status reads open on https://api.kellian.app/api/agent/v1/mcp-discovery; otherwise nothing is created.

An AI app cannot sign, so the bridge signs for this agent. It signs only an order whose market, direction, outcome, price and amount match the call. Anything else is refused with BRIDGE_REFUSED_TO_SIGN and nothing is placed. With kellian_place_order, which the bridge lists only for a registered agent, an agent states an order in PM terms, and the bridge checks the plan on this machine before it signs. The code is in src/walletSigner.ts, src/pmOrder.ts and src/pmOrderCheck.ts.

Coming from Problee

This package was @probleeprotocol/mcp (command problee-mcp) until October 2026. It is the same code under a new name, and its versions restarted at 1.0.1 (see CHANGELOG.md). Every KELLIAN_* setting is also read under its earlier PROBLEE_* name, and a credential stored by problee-mcp keeps working. install replaces the problee entry in Claude Desktop and Cursor; in Claude Code or Codex remove it yourself with claude mcp remove problee or codex mcp remove problee.

Docs

Build from source

npm install
npm run build
node dist/cli.js --help

The Dockerfile builds this source and runs the bridge without a key.

Information, not investment advice. Past performance is not indicative of future results. Not affiliated with Polymarket.

MIT licensed.

Available Tools

31 tools
problee_discover_eventsDescribe the WebSocket transport (URL, auth, message shapes, reconnect protocol) and the WS↔webhook taxonomy bridgeB
Read-onlyIdempotent
Inspect

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.

Inputs: no named parameters. Returns: result

problee_discover_market_dataDescribe canonical market-data lanes for agentsA
Read-onlyIdempotent
Inspect

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 tool calls remain the execution-authoritative path; this describes the realtime/display lanes alongside them.

Inputs: no named parameters. Returns: result

problee_discover_renderersNative renderer catalog (UI hint)A
Read-onlyIdempotent
Inspect

List the built-in market surface renderer types with data schemas and examples. Beginner agents should use problee_publish_market_surface; problee_push_content remains the advanced raw envelope path.

Inputs: no named parameters. Returns: result

problee_discover_resolution_sourcesSelf-documenting catalog — the opaque-envelope shape + conventions agents use for resolutionSourceA
Read-onlyIdempotent
Inspect

Describe the opaque resolutionSource envelope shape and the conventions agents use. No closed enum — agents invent their own type values.

Inputs: no named parameters. Returns: result

problee_discover_webhooksDescribe the webhook signing scheme so agents can verify deliveries without reading sourceA
Read-onlyIdempotent
Inspect

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.

Inputs: no named parameters. Returns: result

problee_get_balanceGet token balances for a walletA
Read-onlyIdempotent
Inspect

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 collateral is the ERC-20 balanceOf. Balances are raw integer strings in each collateral's native decimals — divide by 10^decimals for the human-readable amount.

Inputs: walletAddress (required), chainId, include. Returns: result

problee_get_contractsCanonical protocol addresses, collateral capabilities, and trading approvalsA
Read-onlyIdempotent
Inspect

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(OutcomeToken1155 -> router, true) for a LMSR or orderbook sell today — engine-scoped, so this drops out per settlement venue as each ships approval-free sells (burn-and-mint instead of a pull); check the actual /trade/prepare or /trade/simulate response for one market rather than assuming this list is permanent. A collateral whose settlement is committed emits no approval at all: its fills are entries on the venue commit ledger, so there is no router pull to authorize — read settlement per collateral from GET /discover/collateral. Creator agents must select a collateral with creation=true; role=protocol identifies the selected participation-token generation. Cancel and direct market-local claims need no approval. Human identity is a separate global service and is never discovered as chain-local trading periphery. All addresses are stable/permanent (UUPS) where applicable.

Inputs: chainId, collateral. Returns: result

problee_get_factory_configCreator-policy factory configuration for a chainA
Read-onlyIdempotent
Inspect

Get the release-bound creator-policy factory configuration: supported collaterals with min/max seed amounts, min buy amounts, creator lock requirements, duration limits, and fee structure. Use this before creating markets to know protocol constraints.

Inputs: chainId, factoryType. Returns: result

problee_get_feesCanonical two-lane protocol fee schedule (LMSR + ORDERBOOK factory defaults)A
Read-onlyIdempotent
Inspect

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-market value via tradingRules on market detail or fee on problee_get_quote before executing.

Inputs: no named parameters. Returns: result

problee_get_market_chartPrice history + latest frame for a market across a time windowB
Read-onlyIdempotent
Inspect

Get price history + latest for a market. Window defaults to ALL; supports 1H, 1D, 1W.

Examples: Read the 1D price history for a market

Inputs: address (required), window, chainId. Returns: result

problee_get_market_depth5-level market depth: LMSR buy ladder or live order book, discriminated by kindA
Read-onlyIdempotent
Inspect

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; problee_get_orderbook serves full order-book depth.

Inputs: address (required), chainId. Returns: result

problee_get_market_holdersHolder distribution + open interest for a marketB
Read-onlyIdempotent
Inspect

Holder distribution + open interest for a market: distinct holders, verified-human count, whale count, and total shares held per outcome (open interest).

Inputs: address (required), chainId. Returns: result

problee_get_market_resolution_statePer-market public resolution state and available actionsA
Read-onlyIdempotent
Inspect

Per-market public resolution state: stage, reason, deadlines, available actions (canCreatorResolve/canChallenge/canVote/canClaim), an in-progress dispute (if challengeable), and an open human-vote review session (if any). problee_get_market_state answers only the bare marketState enum; this is the richer resolution-pipeline view.

Inputs: address (required), chainId. Returns: result

problee_get_market_stateCanonical market-state graphC
Read-onlyIdempotent
Inspect

Get the canonical state and state evidence for a market

Inputs: marketAddress (required), chainId. Returns: result

problee_get_market_tradesRecent trades for a market (newest first)B
Read-onlyIdempotent
Inspect

Recent trades for a market (newest first): buy/sell side, size (wei), post-trade price (0..1), and the trader wallet.

Inputs: address (required), limit, chainId. Returns: result

problee_get_positionsList open positions for a wallet (ledger + optional mark-to-market valuation)A
Read-onlyIdempotent
Inspect

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 the canonical indexer price — may lag the chain. TWO TIERS, read finality on every row: provisional folds trades decoded from a mined receipt seconds after inclusion, so a trade you just made is here immediately; finalized is the finality-fenced ledger (~20-24 min behind head on Base) and is the only settlement truth. Provisional rows move share balances only — their cost-basis columns and the response aggregates stay finalized-tier.

Inputs: walletAddress (required), limit, cursor, chainId, +2 more. Returns: result

problee_get_rulesCanonical public protocol rules for resolution windows, bonds, fund flows, and actor actionsA
Read-onlyIdempotent
Inspect

Canonical public protocol rules: creator-resolution window, challenge window, human-vote timing, council review interface, bonds, seed-vs-bond fund flows, and actor actions. Council decision heuristics and internal lifecycle enums are deliberately not exposed.

Inputs: no named parameters. Returns: result

problee_get_server_timeServer time (ms epoch) for clock-skew measurementA
Read-onlyIdempotent
Inspect

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

Inputs: no named parameters. Returns: result

problee_get_token_releaseGet the active participation-token release manifestA
Read-onlyIdempotent
Inspect

Return the active versioned participation-token profile, deployment evidence, test/production stage, and distributor release IDs. This is separate from live market collateral discovery.

Inputs: no named parameters. Returns: result

problee_get_trade_statusLookup a submitted trade by transaction hash and chainA
Read-onlyIdempotent
Inspect

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). Every fill and the envelope itself carry finality. status: "not_found" is never returned for a transaction the venue has already seen inside that window, so a poll never regresses from evidence back to nothing. Act on provisional; settle on finalized.

Inputs: txHash (required), chainId (required). Returns: result

problee_list_capabilitiesList capabilities available to the authenticated agentA
Read-onlyIdempotent
Inspect

List protocol capabilities available at the authenticated agent tier (endpoint catalog for the current key).

Inputs: no named parameters. Returns: result

problee_list_chainsList supported chainsA
Read-onlyIdempotent
Inspect

List all supported blockchain networks

Inputs: no named parameters. Returns: result

problee_list_collateralList public launch collateral tokensA
Read-onlyIdempotent
Inspect

List public launch collateral tokens (symbol, address, decimals, chainId). chainId is optional only when exactly one chain is active.

Inputs: chainId. Returns: result

problee_list_event_typesList all protocol event typesA
Read-onlyIdempotent
Inspect

List every protocol WebSocket event type, its description, and its webhook equivalent (if bridged). Full connection details live in problee_discover_events.

Inputs: no named parameters. Returns: result

problee_list_leaderboardPublic trader, creator, and voter leaderboardA
Read-onlyIdempotent
Inspect

Ranked public leaderboard — the same data human traders see. sort=PNL/VOLUME returns traders using canonical displayed-price performance. Legacy sort=RETURN aliases PNL; return percentage fields are null and no return is calculated. Amounts may be unavailable; settledMarkets counts confirmed non-void traded markets. RISK_ADJ_PNL is a legacy adapter; sort=CREATOR_QUALITY returns creators (track record + tier); sort=VOTERS returns voters. Every row carries the wallet and its black-box reputation tier.

Inputs: sort, limit, offset, period, +3 more. Returns: result

problee_list_market_commentsPosition- and reputation-tagged human comments on a market (read-only)A
Read-onlyIdempotent
Inspect

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 sentiment for trade decisions.

Inputs: address (required), limit, cursor. Returns: result

problee_list_marketsPaginated list of active marketsB
Read-onlyIdempotent
Inspect

List prediction markets on Problee. 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

Inputs: sort, cursor, search, chainId, +5 more. Returns: result

problee_list_pending_resolution_marketsMarkets waiting for resolutionB
Read-onlyIdempotent
Inspect

List markets in the canonical resolution pipeline. Optional category, marketState, cursor, and limit.

Inputs: limit, cursor, category, marketState. Returns: result

problee_list_trade_fillsList a wallet's trade fills, newest first (keyset cursor). Mined-tier fills lead; read `finality`.A
Read-onlyIdempotent
Inspect

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-fenced projection and are the only P&L truth. Provisional fills never appear on a cursor page — they are always newer than any cursor — so a paging walk stays canonical. Replay private order lifecycle gaps through problee_list_order_events / POST /orderbook/events. ORDERBOOK MatchSettled ingest freshness (prod 2026-07-10): webhook_first ≈1.52s from block time. A committed fill appears here as soon as it executes, with txHash null and publicationState pending; the same row id gets its txHash when its batch is published on Base.

Inputs: chainId (required), walletAddress (required), limit, cursor. Returns: result

problee_list_webhook_event_typesList the event types agents can subscribe to, with payload hintsA
Read-onlyIdempotent
Inspect

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.

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

    B3.4/5.0

    Scored across 31 tools

    Disambiguation4/5

    Most tools map to a distinct resource+action, and descriptions explicitly separate near-duplicates (e.g. get_market_state vs get_market_resolution_state, get_market_depth vs full orderbook). The main soft spot is a cluster of four event/webhook tools (list_event_types, list_webhook_event_types, discover_events, discover_webhooks) that require careful reading to tell apart, but their descriptions do distinguish them.

    Naming Consistency5/5

    Every tool follows the same problee_<verb>_<noun> convention using consistent verbs (get, list, discover), with no camelCase or style mixing. Predictable and easy to scan.

    Tool Count3/5

    31 tools is heavy and beyond the typical well-scoped band, though the domain (markets, trading, resolution, discovery, events, webhooks, protocol config) is genuinely broad so most tools earn a place. It sits at the borderline-to-heavy end rather than being clearly excessive.

    Completeness3/5

    Read/discovery coverage is thorough (markets, positions, balance, trades, resolution, leaderboard, fees, contracts, rules, events, webhooks). However the surface is heavily read-oriented: there is no explicit market-creation or trade-execution/prepare tool in the set, even though descriptions reference publishing surfaces and /trade/prepare, leaving notable write-path gaps.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Trade and monitor prediction markets across Polymarket, Kalshi, Opinion, Limitless, and PredictFun from any AI agent. Unified real-time data, live orderbook streaming, and order execution — one API key, one interface, five exchanges.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to discover and analyze prediction markets, execute trades, and manage positions on Polymarket via the Model Context Protocol.
      7
      106 npm
      20
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables MCP-compatible AI agents to research and trade prediction markets on Polymarket and Kalshi, including market search, orderbooks, price history, positions, order routing, and on-chain builder-code attribution, plus overshoot and dispute-risk signals.
      42
      1
      MIT