# simplefunctions MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-spfunctions-simplefunctions
- Repository: https://github.com/spfunctions/simplefunctions-cli

## Install
- Command: `npx -y @spfunctions/cli`
- Endpoint: https://simplefunctions.dev/api/mcp/mcp
- Auth: Not captured

## Setup notes
- Package: Npm @spfunctions/cli v1.7.22
- Remote endpoint: https://simplefunctions.dev/api/mcp/mcp

## Tools
- get_context - 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. No auth needed for global context. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_theses - List all theses for the authenticated user. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- inject_signal - Feed an observation into a thesis — news, price move, or external event. Consumed in next evaluation cycle to update confidence and edges. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- trigger_evaluation - Force immediate evaluation: consume all pending signals, re-scan edges, update confidence. Use after injecting important signals. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- scan_markets - Search Kalshi prediction markets by keyword, series, or ticker. Returns live prices and volume — data not available via web search. No auth required. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- create_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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- explore_public - Browse public theses from other users. No auth required. Pass a slug to get details, or omit to list all. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_markets - 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). Endpoint: https://simplefunctions.dev/api/mcp/mcp
- query_databento - 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. No auth required. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- query - 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. No auth required. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- screen_markets - 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. Use this to bulk-discover candidates before paying any LLM cost. No auth required. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- create_strategy - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_strategies - Advanced: List trading strategies for a thesis. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- update_strategy - Advanced: Update a trading strategy (stop loss, take profit, status). Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_milestones - Get upcoming events from Kalshi calendar (economic releases, political events, catalysts). No auth required. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_forecast - Advanced: P50/P75/P90 percentile distribution for a Kalshi event — shows how market consensus shifted over time. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_settlements - Advanced: Settled contracts with realized P&L. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_balance - Advanced: Kalshi account balance and portfolio value. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_orders - Advanced: Current resting orders on Kalshi. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_schedule - Get exchange status and trading hours Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_fills - Advanced: Recent trade fills on Kalshi. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- what_if - Scenario analysis: "what if OPEC cuts production?" Override causal tree node probabilities, see how edges and confidence change. Zero LLM cost, instant. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- augment_tree - Advanced: Merge suggested causal tree nodes from evaluations into the tree (append-only). Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_edges - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_trade_ideas - 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. No auth required. START HERE when looking for what to trade. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- create_intent - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_intents - List execution intents — pending, armed, triggered, executing, partial, filled, expired, cancelled, rejected. Shows the full execution pipeline status. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- cancel_intent - Cancel an active intent. Stops trigger evaluation and prevents execution. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- search_x - Search X/Twitter for social sentiment on any topic. Returns posts sorted by engagement. Not available via web search — uses X API directly. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- x_volume - Advanced: X/Twitter discussion volume trend — timeseries, velocity, peak activity. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- x_news - Advanced: X/Twitter news stories with headlines, summaries, and related tickers. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- x_account - Advanced: Recent posts from a specific X/Twitter account. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- configure_heartbeat - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- update_thesis - Update thesis metadata: title, lifecycle status (active/paused/archived), webhookUrl. Use configure_heartbeat.paused for runtime heartbeat pause/resume. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- add_position - Record a new position in a thesis for tracking. Use after an intent fills or a manual trade. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- update_position - Update a position: current price, edge, size, status (open→closed). Use to mark positions as closed or update tracking data. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- close_position - Delete a position record from a thesis. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_evaluation_history - Confidence trajectory over time — daily aggregated evaluations for a thesis. Use to analyze trends, detect convergence/divergence. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- update_nodes - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_heartbeat_status - Get heartbeat config + this month's cost summary for a thesis. See news/X scan intervals, model tier, budget usage. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- monitor_the_situation - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- enrich_content - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- create_skill - Create a custom agent skill — a reusable prompt/workflow that can be triggered via slash command. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_skills - List all skills: built-in + user-created custom skills. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- run_skill - Get a skill by ID or trigger to run it. Returns the skill prompt and metadata. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- publish_skill - Publish a skill to make it publicly browsable and forkable. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- fork_skill - Fork a public skill into your collection. No slug needed — just the skill ID. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- browse_public_skills - Browse public skills from the community. No auth required. Filter by category, search, or sort by popularity. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- fork_thesis - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_world_state - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_world_delta - Incremental world state update — only what changed since a timestamp. ~30-50 tokens vs 800 for full state. For periodic refresh during long tasks. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- read_forum - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- post_to_forum - Post a message to the agent forum. Share discoveries, edges, coordination signals with other agents. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- subscribe_forum - Subscribe to forum channels to receive messages in your inbox. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- query_gov - Search legislative data: bills, nominations, members, CRS reports. Cross-references with prediction markets. Use for political/policy questions. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- query_econ - Search official economic time series from FRED-backed data. Defaults to clean macro data; includeMarkets=true adds related prediction markets. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- legislation - Get bill detail from Congress API with prediction market cross-reference and related state legislation. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- inspect_ticker - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_market_detail - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_market_history - Get rolling 7-day price + indicator history for a single market. For trajectory questions and chart rendering. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_market_microstructure_history - Per-ticker microstructure time series: implicit yield, CRI, EE, LAS, overround, plus realised volatility. Used for charting indicator drift. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- batch_markets - Fetch many markets at once by ticker list. Cheaper than calling get_market_detail in a loop. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- screen_by_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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_index_history - Historical SimpleFunctions Index snapshots. Pre-computed every 15 minutes, stored since v2 launch (2026-04-09). For charting trends. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_regime_scan - Scan markets by regime label (bull, bear, range, frontier, panic) with optional indicator filters. For regime-based screening. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_contagion - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_market_diff - Diff a market vs the prior window: price delta, volume delta, indicator drift. For "what changed in the last 6h?" questions. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_highlights - Editorial highlights for the day: top movers, divergences, fresh contagion, freshly-resolved markets. Curated summary view. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_briefing - Topic-scoped briefing: short narrative + relevant markets + prior moves + key dates. Reusable as a callable /briefing card. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_calendar - Upcoming dated events that drive prediction markets: FOMC, CPI release, election dates, sports finals. Returns date, topic, and linked tickers. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_economic_anchors - Macro/economic anchors from FRED: latest values, percentile vs history, crosswalk to relevant prediction markets. For grounding macro theses. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_yield_curves - Liquidity-weighted yield curves across event types (e.g. KXFED 6mo, KXBTC 30d). For "where on the curve am I trading?" questions. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_yield_curve - Single yield curve for one event series. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_newmarkets - Recently-listed markets (new contracts) on Kalshi and Polymarket. For finding fresh trading opportunities. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_calibration - SimpleFunctions calibration: Brier scores, hit rates by edge bucket, category breakdown, drift alerts. Measured against resolved/settled markets. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_answer - Pre-computed answer card for a probability question (the same data that powers /answer/{slug}). Returns probability, confidence, and citations. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_agent_guide - Runtime playbook for agents: step-by-step workflows for query / monitor / integrate intents. Use when an agent is lost or needs onboarding. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- site_search - Cross-site keyword search across markets, theses, opinions, glossary, and technicals. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_changes - Market change events since a timestamp: new contracts, price moves, removed contracts. Used by the live feed and agent context refreshers. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_skills - List authenticated user's skills. (Public skills are at browse_public_skills.) Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_public_skill - Get a single published skill by slug. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_glossary - List glossary terms (prediction market vocabulary, indicators, regimes). Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_glossary_term - Get a single glossary term with full definition and links. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_opinions - List SimpleFunctions opinions/essays — analysis, tutorials, and long-form takes on prediction markets, causal models, agent-driven trading. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_opinion - Get a single opinion/essay by slug. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_technicals - List technical reference docs (orderbook semantics, fee model, indicator definitions). Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_technical - Get a single technical reference doc by slug. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_legislation - List Congress bills with optional filter for ones cross-referenced to prediction markets. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_congress_members - List sitting US Congress members. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_congress_member - Get a single Congress member by bioguide ID. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_feed - Cross-thesis evaluation feed: every evaluation across all your theses, ordered descending. Powers `sf feed` CLI. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_changes_delta - Per-thesis change delta since a timestamp — what evolved on this thesis (signals consumed, edges updated, confidence moves). Endpoint: https://simplefunctions.dev/api/mcp/mcp
- list_forum_channels - List available forum channels (general, alerts, signals, etc.) the agent can read or post to. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_positions - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_thesis_context - 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. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- tts - Text-to-speech proxy. Returns audio bytes encoded as base64. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- stt - Speech-to-text proxy. Pass base64-encoded audio, get transcribed text. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- explore_theses - Browse public theses (alias of explore_public). Pass slug to get one, omit to list. Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_heartbeat_config - Get heartbeat config + monthly cost summary for a thesis (alias of get_heartbeat_status). Endpoint: https://simplefunctions.dev/api/mcp/mcp
- get_legislation - Get bill detail with prediction-market cross-reference (alias of legislation). Endpoint: https://simplefunctions.dev/api/mcp/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.spfunctions
- Version: 1.1.0
- Runtime: Npm
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Apr 2, 2026
- Source: https://registry.modelcontextprotocol.io