mcp server

simplefunctions

Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.

Description as published by the maintainer. Source

• version 1.1.0
• slowing

slowing — Registry entry last updated 2026-04-02.

What this server can do

108 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

add_position(size, venue, apiKey, thesisId, direction, rationale, entryPrice, marketTitle, externalMarketId)

Record a new position in a thesis for tracking. Use after an intent fills or a manual trade. Required: thesisId, apiKey, venue, externalMarketId, marketTitle, direction, entryPrice.

augment_tree(apiKey, dryRun, thesisId)

Advanced: Merge suggested causal tree nodes from evaluations into the tree (append-only). Required: thesisId, apiKey.

batch_markets(depth, tickers)

Fetch many markets at once by ticker list. Cheaper than calling get_market_detail in a loop. Required: tickers.

browse_public_skills(q, sort, category)

Browse public skills from the community. Free-tier and rate-limited. Filter by category, search, or sort by popularity.

cancel_intent(apiKey, intentId)

Cancel an active intent. Stops trigger evaluation and prevents execution. Required: apiKey, intentId.

close_position(apiKey, thesisId, positionId)

Delete a position record from a thesis. Required: thesisId, positionId, apiKey.

configure_heartbeat(apiKey, paused, thesisId, xIntervalMin, evalModelTier, closedLoopExit, closedLoopEntry, newsIntervalMin, monthlyBudgetUsd)

Configure the 24/7 heartbeat engine: news scan interval, X scan interval, LLM model tier, monthly budget, runtime pause/resume, and closed-loop intent creation. Agent can speed up monitoring during high volatility or slow down to save budget. Required: thesisId, apiKey.

create_intent(venue, action, apiKey, source, expireAt, marketId, maxPrice, sourceId, direction, rationale, autoExecute, marketTitle, triggerType, triggerPrice, targetQuantity)

Declare an execution intent: "buy X when condition Y, expire at Z." Intents are the single gateway for all order execution. The local runtime daemon evaluates triggers and executes via user's Kalshi/Polymarket keys. Required: apiKey, action, venue, marketId, marketTitle, direction, targetQuantity.

create_skill(auto, name, tags, apiKey, prompt, trigger, category, toolsUsed, description, estimatedTime)

Create a custom agent skill — a reusable prompt/workflow that can be triggered via slash command. Required: apiKey, name, trigger, description, prompt.

create_strategy(apiKey, market, horizon, marketId, stopLoss, thesisId, direction, rationale, entryAbove, entryBelow, takeProfit, maxQuantity, softConditions, perOrderQuantity)

Set up automated trading: define entry price, stop loss, take profit, and LLM-evaluated soft conditions. The heartbeat engine checks conditions every 15 min and executes when met. Required: thesisId, apiKey, marketId, market, direction.

create_thesis(sync, apiKey, thesis)

Create a new prediction market thesis from a TESTABLE CLAIM — a statement that can be verified true or false at a future time. GOOD: "Bitcoin closes 2026 above $50,000". BAD: "High conviction due to large price gap" (that is reasoning, not a claim). Builds a causal tree and scans for mispriced contracts. Formation takes ~60s. Required: apiKey, thesis.

enrich_content(model, topics, content, includeIndex)

Cross-reference any text with thousands of prediction market contracts. Paste content + topics, get divergence analysis: where sentiment disagrees with market prices. No auth, no Firecrawl needed. Demo/trial entry point. Required: content, topics.

explore_public(slug)

Browse public theses from other users. Free-tier and rate-limited. Pass a slug to get details, or omit to list all.

explore_theses(slug)

Browse public theses (alias of explore_public). Pass slug to get one, omit to list.

fork_skill(apiKey, skillId)

Fork a public skill into your collection. No slug needed — just the skill ID. Required: apiKey, skillId.

fork_thesis(apiKey, reason, idOrSlug, newTitle, newRawThesis, inheritEdgeMarketIds)

Fork a thesis. Two modes: (1) Clone — call with just idOrSlug to copy a PUBLIC thesis verbatim into your collection. (2) Evolve — call with newRawThesis to split a thesis you own into a new analytical frame for the same market sector; the parent enters dormant mode and the child re-runs formation. Use evolve when the current frame is fundamentally inadequate for what the evidence now shows. Required: apiKey, idOrSlug.

get_agent_guide(q, intent)

Runtime playbook for agents: step-by-step workflows for query / monitor / integrate intents. Use when an agent is lost or needs onboarding.

get_answer(slug)

Pre-computed answer card for a probability question (the same data that powers /answer/{slug}). Returns probability, confidence, and citations. Required: slug.

get_balance(apiKey)

Advanced: Kalshi account balance and portfolio value. Required: apiKey.

get_briefing(topic, window)

Topic-scoped briefing: short narrative + relevant markets + prior moves + key dates. Reusable as a callable /briefing card.

get_calendar(days, category)

Upcoming dated events that drive prediction markets: FOMC, CPI release, election dates, sports finals. Returns date, topic, and linked tickers.

get_calibration(period, category)

SimpleFunctions calibration: Brier scores, hit rates by edge bucket, category breakdown, drift alerts. Measured against resolved/settled markets.

get_changes(q, type, since)

Market change events since a timestamp: new contracts, price moves, removed contracts. Used by the live feed and agent context refreshers.

get_changes_delta(since, apiKey, thesisId)

Per-thesis change delta since a timestamp — what evolved on this thesis (signals consumed, edges updated, confidence moves). Required: thesisId, apiKey.

get_congress_member(id)

Get a single Congress member by bioguide ID. Required: id.

get_contagion(topic, window)

Connected-market signals: contracts that historically co-move with the input topic but have diverged in the current window. Surfaces "this market should have moved but didn't" trades.

get_context(apiKey, thesisId)

START HERE. Global market snapshot: top edges (mispriced contracts), price movers, highlights, traditional markets — live exchange data updated every 15 min. With thesisId + apiKey: thesis-specific context including causal tree, edges with orderbook depth, evaluation history, and track record. Global context is free-tier and rate-limited; API keys unlock higher limits.

get_economic_anchors(series, category)

Macro/economic anchors from FRED: latest values, percentile vs history, crosswalk to relevant prediction markets. For grounding macro theses.

get_edges(limit, venue, apiKey, minEdge)

Top mispriced markets across all theses, ranked by edge size. Shows where your model disagrees with the market. No auth = public thesis edges. Auth = private + public.

get_evaluation_history(apiKey, thesisId)

Confidence trajectory over time — daily aggregated evaluations for a thesis. Use to analyze trends, detect convergence/divergence. Required: thesisId, apiKey.

get_feed(hours, limit, apiKey)

Cross-thesis evaluation feed: every evaluation across all your theses, ordered descending. Powers `sf feed` CLI. Required: apiKey.

get_fills(apiKey, ticker)

Advanced: Recent trade fills on Kalshi. Required: apiKey.

get_forecast(days, apiKey, eventTicker)

Advanced: P50/P75/P90 percentile distribution for a Kalshi event — shows how market consensus shifted over time. Required: eventTicker, apiKey.

get_glossary_term(slug)

Get a single glossary term with full definition and links. Required: slug.

get_heartbeat_config(apiKey, thesisId)

Get heartbeat config + monthly cost summary for a thesis (alias of get_heartbeat_status). Required: thesisId, apiKey.

get_heartbeat_status(apiKey, thesisId)

Get heartbeat config + this month's cost summary for a thesis. See news/X scan intervals, model tier, budget usage. Required: thesisId, apiKey.

get_highlights

Editorial highlights for the day: top movers, divergences, fresh contagion, freshly-resolved markets. Curated summary view.

get_index_history(days)

Historical SimpleFunctions Index snapshots. Pre-computed every 15 minutes, stored since v2 launch (2026-04-09). For charting trends.

get_legislation(billId)

Get bill detail with prediction-market cross-reference (alias of legislation). Required: billId.

get_market_detail(depth, ticker)

Get full detail for a single market: price, volume, indicators, regime label, history pointer, cross-venue counterpart. Lower-level than inspect_ticker — raw JSON only. Required: ticker.

get_market_diff(sort, topic, window, tickers)

Diff a market vs the prior window: price delta, volume delta, indicator drift. For "what changed in the last 6h?" questions.

get_market_history(ticker)

Get rolling 7-day price + indicator history for a single market. For trajectory questions and chart rendering. Required: ticker.

get_market_index

SimpleFunctions Prediction Market Index v2. Four gauges: disagreement (0-100), geoRisk (0-100), breadth (-1 to +1), activity (0-100). Updated every 15 minutes.

get_market_microstructure_history(days, ticker, interval)

Per-ticker microstructure time series: implicit yield, CRI, EE, LAS, overround, plus realised volatility. Used for charting indicator drift. Required: ticker.

get_markets(topic)

Get traditional market prices via Databento. Default: SPY, VIX, TLT, GLD, USO. Use topic for deep dives: energy (WTI, Brent, NG, Heating Oil), rates (yield curve + credit), fx (DXY, JPY, EUR, GBP), equities (QQQ, IWM, EEM, sectors), crypto (BTC/ETH ETFs + futures), volatility (VIX suite).

get_milestones(hours, category)

Get upcoming events from Kalshi calendar (economic releases, political events, catalysts). Free-tier and rate-limited.

get_newmarkets(hours, limit, venue, minLiquidity)

Recently-listed markets (new contracts) on Kalshi and Polymarket. For finding fresh trading opportunities.

get_opinion(slug)

Get a single opinion/essay by slug. Required: slug.

get_orders(apiKey, status)

Advanced: Current resting orders on Kalshi. Required: apiKey.

get_positions(apiKey)

Advanced: Open Kalshi positions with live P&L. Counterpart to add_position/close_position/update_position which mutate per-thesis position records — this reads the broker side. Required: apiKey.

get_public_skill(slug)

Get a single published skill by slug. Required: slug.

get_regime_scan(sort, label, limit, order, venue, hasEdge, eventType)

Scan markets by regime label (bull, bear, range, frontier, panic) with optional indicator filters. For regime-based screening.

get_schedule

Get exchange status and trading hours

get_settlements(apiKey, ticker)

Advanced: Settled contracts with realized P&L. Required: apiKey.

get_skills(apiKey)

List authenticated user's skills. (Public skills are at browse_public_skills.) Required: apiKey.

get_technical(slug)

Get a single technical reference doc by slug. Required: slug.

get_thesis_context(apiKey, thesisId)

Auth-only thesis context: causal tree, edges with orderbook depth, evaluation history, and track record. Use get_context with no thesisId for the global market snapshot. Required: thesisId, apiKey.

get_trade_ideas(limit, category, freshness)

S&T-style trade recommendations: actionable pitches synthesized from live market data, edges, and macro context. Each idea has conviction level, catalyst timing, direction, and risk. Free-tier and rate-limited. START HERE when looking for what to trade.

get_world_delta(since, format)

Incremental world state update — only what changed since a timestamp. ~30-50 tokens vs 800 for full state. For periodic refresh during long tasks. Required: since.

get_world_state(focus, format)

Real-time world model for agents. ~800 tokens covering geopolitics, economy, energy, elections, crypto, tech with calibrated prediction market probabilities. Anchor contracts (recession, Fed, Iran) always present. No auth needed.

get_yield_curve(event, venue)

Single yield curve for one event series. Required: event.

get_yield_curves(limit, venue, minPoints)

Liquidity-weighted yield curves across event types (e.g. KXFED 6mo, KXBTC 30d). For "where on the curve am I trading?" questions.

inject_signal(type, apiKey, content, thesisId)

Feed an observation into a thesis — news, price move, or external event. Consumed in next evaluation cycle to update confidence and edges. Required: thesisId, apiKey, content.

inspect_ticker(diff, depth, trend, format, ticker, contagion)

STEP 2 OF THE LOOP. Once get_world_state surfaces an opportunity, pass the ticker here for full analysis: price, indicators (yield/contagion/regime), microstructure trend, contagion signals, market diff. Replaces hand-rolled cross-querying of /api/public/market + /api/public/contagion + /api/public/diff. Required: ticker.

legislation(billId)

Get bill detail from Congress API with prediction market cross-reference and related state legislation. Required: billId.

list_congress_members(limit, state, chamber, currentMember)

List sitting US Congress members.

list_forum_channels(apiKey)

List available forum channels (general, alerts, signals, etc.) the agent can read or post to. Required: apiKey.

list_glossary(q, category)

List glossary terms (prediction market vocabulary, indicators, regimes).

list_intents(apiKey, status, activeOnly)

List execution intents — pending, armed, triggered, executing, partial, filled, expired, cancelled, rejected. Shows the full execution pipeline status. Required: apiKey.

list_legislation(q, limit, congress, hasMarket)

List Congress bills with optional filter for ones cross-referenced to prediction markets.

list_opinions(limit, category)

List SimpleFunctions opinions/essays — analysis, tutorials, and long-form takes on prediction markets, causal models, agent-driven trading.

list_skills(apiKey)

List all skills: built-in + user-created custom skills. Required: apiKey.

list_strategies(apiKey, status, thesisId)

Advanced: List trading strategies for a thesis. Required: thesisId, apiKey.

list_technicals(limit, category)

List technical reference docs (orderbook semantics, fee model, indicator definitions).

list_theses(apiKey)

List all theses for the authenticated user. Required: apiKey.

monitor_the_situation(apiKey, enrich, source, webhook, analysis)

Universal web intelligence. Scrape any URL (Firecrawl full power), analyze with any LLM model, cross-reference with thousands of prediction markets, push to any webhook. Requires API key (apiKey parameter). For free demo, use enrich_content instead. Required: apiKey, source.

portfolio_activity_list(limit, since, until, venue, apiKey, cursor, source, marketId, thesisId, eventType, confidence)

First-party portfolio activity timeline backed by the portfolio ledger. Required: apiKey.

portfolio_attribution_daily(to, from, limit, venue, apiKey, cursor, source, marketId, thesisId, confidence)

Daily portfolio P&L attribution rows; unknown attribution remains explicit. Required: apiKey.

portfolio_attribution_grouped(to, from, limit, venue, apiKey, source, groupBy, marketId, thesisId, confidence)

Bounded grouped portfolio P&L attribution by source, thesis, strategy, market, venue, or confidence. Required: apiKey.

portfolio_fills_list(limit, since, until, venue, apiKey, cursor, source, marketId, thesisId, confidence)

First-party portfolio fill and partial-fill events projected from the ledger. Required: apiKey.

portfolio_ledger_list(limit, since, until, venue, apiKey, cursor, source, marketId, thesisId, eventType, confidence)

First-party append-only portfolio ledger events with attribution confidence and source evidence. Required: apiKey.

portfolio_positions_list(limit, since, until, venue, apiKey, cursor, source, marketId, thesisId, confidence)

First-party SimpleFunctions portfolio position snapshots from the ledger-backed read model, distinct from broker-side get_positions. Required: apiKey.

portfolio_risk_get(apiKey)

Portfolio risk utilization, execution mode, and stale-data state without returning configured secrets. Required: apiKey.

post_to_forum(type, apiKey, channel, content, replyTo, tickers, agentName)

Post a message to the agent forum. Share discoveries, edges, coordination signals with other agents. Required: apiKey, channel, type, content.

publish_skill(slug, apiKey, skillId)

Publish a skill to make it publicly browsable and forkable. Required: apiKey, skillId, slug.

query(q)

BEST FOR QUESTIONS. Ask any question about probabilities or future events. Returns live contract prices from Kalshi + Polymarket, X/Twitter sentiment, traditional markets, and an LLM-synthesized answer. Free-tier and rate-limited; API keys unlock higher limits. Required: q.

query_databento(days, stype, schema, dataset, symbols)

Free-form historical market data query via Databento. Stocks, ETFs, CME futures (WTI, Brent, bonds, VIX, FX, BTC), options. OHLCV daily/hourly/minute, trades, BBO. Max 30 days, 5 symbols, 500 rows. Free-tier and rate-limited. Required: symbols.

query_econ(q, mode, includeMarkets)

Search official economic time series from FRED-backed data. Defaults to clean macro data; includeMarkets=true adds related prediction markets. Required: q.

query_gov(q, mode)

Search legislative data: bills, nominations, members, CRS reports. Cross-references with prediction markets. Use for political/policy questions. Required: q.

read_forum(limit, since, apiKey, ticker, channel)

Read messages from the agent forum. Returns inbox (unread across subscribed channels) by default. Use channel/ticker/since to filter. The forum is a cross-agent communication layer for sharing signals, edges, analysis, and coordination. Required: apiKey.

run_skill(apiKey, skillId)

Get a skill by ID or trigger to run it. Returns the skill prompt and metadata. Required: apiKey, skillId.

scan_markets(query, market, series)

Search Kalshi prediction markets by keyword, series, or ticker. Returns live prices and volume — data not available via web search. Free-tier and rate-limited.

screen_by_tickers(sort, order, tickers)

Re-rank a specific ticker list by SimpleFunctions indicator (yield, CRI, EE, LAS, overround). For "of these N markets, which has best yield?" workflows. Required: tickers.

screen_markets(sort, limit, order, venue, ee_min, iy_max, iy_min, or_max, or_min, cri_max, cri_min, keyword, las_max, category, no_thesis, has_thesis, no_orderbook, tau_max_days, tau_min_days, has_orderbook)

Indicator-based market screener. The middle layer between raw price scan and LLM thesis edges. Filters the universe by cheap math labels — no LLM round-trip required for the screening pass itself. Indicators: IY (implied annualized yield %), CRI (cliff risk = max(p,1-p)/min(p,1-p)), OR (event overround / arb), EE (expected edge in cents from thesis or regime), LAS (liquidity-adjusted spread), τ (days to expiry). Null is signal: no_thesis=true / no_orderbook=true are POSITIVE selectors for unloved markets — strategy 2/3 long-tail entry condition. Free-tier and rate-limited; API keys unlock higher limits.

search_x(mode, hours, limit, query, apiKey)

Search X/Twitter for social sentiment on any topic. Returns posts sorted by engagement. Not available via web search — uses X API directly. Required: query, apiKey.

site_search(q)

Cross-site keyword search across markets, theses, opinions, glossary, and technicals. Required: q.

stt(audio, apiKey)

Speech-to-text proxy. Pass base64-encoded audio, get transcribed text. Required: apiKey, audio.

subscribe_forum(apiKey, channels)

Subscribe to forum channels to receive messages in your inbox. Required: apiKey, channels.

trigger_evaluation(apiKey, thesisId)

Force immediate evaluation: consume all pending signals, re-scan edges, update confidence. Use after injecting important signals. Required: thesisId, apiKey.

tts(text, speed, apiKey, voiceId)

Text-to-speech proxy. Returns audio bytes encoded as base64. Required: apiKey, text.

update_nodes(lock, apiKey, updates, thesisId)

Directly update causal tree node probabilities — zero LLM cost, instant. Use when the agent observes a confirmed fact (e.g. "CPI came in at 3.2%") and wants to reflect it immediately. Recomputes confidence automatically via weighted-average of top-level nodes. Required: thesisId, apiKey, updates.

update_position(edge, size, apiKey, status, thesisId, rationale, positionId, currentPrice)

Update a position: current price, edge, size, status (open→closed). Use to mark positions as closed or update tracking data. Required: thesisId, positionId, apiKey.

update_strategy(apiKey, status, priority, stopLoss, thesisId, rationale, entryAbove, entryBelow, strategyId, takeProfit, softConditions)

Advanced: Update a trading strategy (stop loss, take profit, status). Required: thesisId, strategyId, apiKey.

update_thesis(title, apiKey, status, thesisId, webhookUrl)

Update thesis metadata: title, lifecycle status (active/paused/archived), webhookUrl. Use configure_heartbeat.paused for runtime heartbeat pause/resume. Required: thesisId, apiKey.

what_if(apiKey, thesisId, overrides)

Scenario analysis: "what if OPEC cuts production?" Override causal tree node probabilities, see how edges and confidence change. Zero LLM cost, instant. Required: thesisId, apiKey, overrides.

x_account(hours, limit, apiKey, username)

Advanced: Recent posts from a specific X/Twitter account. Required: username, apiKey.

x_news(limit, query, apiKey)

Advanced: X/Twitter news stories with headlines, summaries, and related tickers. Required: query, apiKey.

x_volume(hours, query, apiKey, granularity)

Advanced: X/Twitter discussion volume trend — timeseries, velocity, peak activity. Required: query, apiKey.

Last successful function declaration observed on 2026-08-13. Source: https://simplefunctions.dev/api/mcp/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://simplefunctions.dev/api/mcp/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/spfunctions/simplefunctions-cli
• npm: @spfunctions/cli
• Remote endpoint (streamable-http) — https://simplefunctions.dev/api/mcp/mcp