simplefunctions
Calibrated world model for AI agents.
Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeRead-only
What it can do
What data it sees
Do you need an account
No: the server works without sign-in
Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.
How to connect
How to connect simplefunctions to Claude
The server address to paste into Claude settings:
https://simplefunctions.dev/api/mcp/mcp
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect simplefunctions to ChatGPT
The server address to paste into ChatGPT settings:
https://simplefunctions.dev/api/mcp/mcp
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect simplefunctions to Cursor
The server address to paste into Cursor settings:
https://simplefunctions.dev/api/mcp/mcp
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (108)
Raw names from tools/list. Only developers need these.
| 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. Global context is free-tier and rate-limited; API keys unlock higher limits. |
| list_theses | List all theses for the authenticated user. |
| inject_signal | Feed an observation into a thesis — news, price move, or external event. Consumed in next evaluation cycle to update confidence and edges. |
| trigger_evaluation | Force immediate evaluation: consume all pending signals, re-scan edges, update confidence. Use after injecting important signals. |
| scan_markets | 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. |
| 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. |
| explore_public | Browse public theses from other users. Free-tier and rate-limited. Pass a slug to get details, or omit to list all. |
| 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). |
| 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. Free-tier and rate-limited. |
| 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. Free-tier and rate-limited; API keys unlock higher limits. |
| 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. Free-tier and rate-limited; API keys unlock higher limits. |
| 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. |
| list_strategies | Advanced: List trading strategies for a thesis. |
| update_strategy | Advanced: Update a trading strategy (stop loss, take profit, status). |
| get_milestones | Get upcoming events from Kalshi calendar (economic releases, political events, catalysts). Free-tier and rate-limited. |
| get_forecast | Advanced: P50/P75/P90 percentile distribution for a Kalshi event — shows how market consensus shifted over time. |
| get_settlements | Advanced: Settled contracts with realized P&L. |
| get_balance | Advanced: Kalshi account balance and portfolio value. |
| get_orders | Advanced: Current resting orders on Kalshi. |
| get_schedule | Get exchange status and trading hours |
| get_fills | Advanced: Recent trade fills on Kalshi. |
| what_if | Scenario analysis: "what if OPEC cuts production?" Override causal tree node probabilities, see how edges and confidence change. Zero LLM cost, instant. |
| augment_tree | Advanced: Merge suggested causal tree nodes from evaluations into the tree (append-only). |
| 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. |
| 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. Free-tier and rate-limited. START HERE when looking for what to trade. |
| 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. |
| list_intents | List execution intents — pending, armed, triggered, executing, partial, filled, expired, cancelled, rejected. Shows the full execution pipeline status. |
| cancel_intent | Cancel an active intent. Stops trigger evaluation and prevents execution. |
| 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. |
| x_volume | Advanced: X/Twitter discussion volume trend — timeseries, velocity, peak activity. |
| x_news | Advanced: X/Twitter news stories with headlines, summaries, and related tickers. |
| x_account | Advanced: Recent posts from a specific X/Twitter account. |
| 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. |
| update_thesis | Update thesis metadata: title, lifecycle status (active/paused/archived), webhookUrl. Use configure_heartbeat.paused for runtime heartbeat pause/resume. |
| add_position | Record a new position in a thesis for tracking. Use after an intent fills or a manual trade. |
| update_position | Update a position: current price, edge, size, status (open→closed). Use to mark positions as closed or update tracking data. |
| close_position | Delete a position record from a thesis. |
| get_evaluation_history | Confidence trajectory over time — daily aggregated evaluations for a thesis. Use to analyze trends, detect convergence/divergence. |
| 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. |
| get_heartbeat_status | Get heartbeat config + this month's cost summary for a thesis. See news/X scan intervals, model tier, budget usage. |
| 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. |
| 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. |
| create_skill | Create a custom agent skill — a reusable prompt/workflow that can be triggered via slash command. |
| list_skills | List all skills: built-in + user-created custom skills. |
| run_skill | Get a skill by ID or trigger to run it. Returns the skill prompt and metadata. |
| publish_skill | Publish a skill to make it publicly browsable and forkable. |
| fork_skill | Fork a public skill into your collection. No slug needed — just the skill ID. |
| browse_public_skills | Browse public skills from the community. Free-tier and rate-limited. Filter by category, search, or sort by popularity. |
| 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. |
| 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. |
| 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. |
| 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. |
| post_to_forum | Post a message to the agent forum. Share discoveries, edges, coordination signals with other agents. |
| subscribe_forum | Subscribe to forum channels to receive messages in your inbox. |
| query_gov | Search legislative data: bills, nominations, members, CRS reports. Cross-references with prediction markets. Use for political/policy questions. |
| query_econ | Search official economic time series from FRED-backed data. Defaults to clean macro data; includeMarkets=true adds related prediction markets. |
| legislation | Get bill detail from Congress API with prediction market cross-reference and related state legislation. |
| 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. |
| 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. |
| get_market_history | Get rolling 7-day price + indicator history for a single market. For trajectory questions and chart rendering. |
| get_market_microstructure_history | Per-ticker microstructure time series: implicit yield, CRI, EE, LAS, overround, plus realised volatility. Used for charting indicator drift. |
| batch_markets | Fetch many markets at once by ticker list. Cheaper than calling get_market_detail in a loop. |
| 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. |
| 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_index_history | Historical SimpleFunctions Index snapshots. Pre-computed every 15 minutes, stored since v2 launch (2026-04-09). For charting trends. |
| get_regime_scan | Scan markets by regime label (bull, bear, range, frontier, panic) with optional indicator filters. For regime-based screening. |
| 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. |
| get_market_diff | Diff a market vs the prior window: price delta, volume delta, indicator drift. For "what changed in the last 6h?" questions. |
| get_highlights | Editorial highlights for the day: top movers, divergences, fresh contagion, freshly-resolved markets. Curated summary view. |
| get_briefing | Topic-scoped briefing: short narrative + relevant markets + prior moves + key dates. Reusable as a callable /briefing card. |
| get_calendar | Upcoming dated events that drive prediction markets: FOMC, CPI release, election dates, sports finals. Returns date, topic, and linked tickers. |
| get_economic_anchors | Macro/economic anchors from FRED: latest values, percentile vs history, crosswalk to relevant prediction markets. For grounding macro theses. |
| 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. |
| get_yield_curve | Single yield curve for one event series. |
| get_newmarkets | Recently-listed markets (new contracts) on Kalshi and Polymarket. For finding fresh trading opportunities. |
| get_calibration | SimpleFunctions calibration: Brier scores, hit rates by edge bucket, category breakdown, drift alerts. Measured against resolved/settled markets. |
| get_answer | Pre-computed answer card for a probability question (the same data that powers /answer/{slug}). Returns probability, confidence, and citations. |
| 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. |
| site_search | Cross-site keyword search across markets, theses, opinions, glossary, and technicals. |
| get_changes | Market change events since a timestamp: new contracts, price moves, removed contracts. Used by the live feed and agent context refreshers. |
| get_skills | List authenticated user's skills. (Public skills are at browse_public_skills.) |
| get_public_skill | Get a single published skill by slug. |
| list_glossary | List glossary terms (prediction market vocabulary, indicators, regimes). |
| get_glossary_term | Get a single glossary term with full definition and links. |
| list_opinions | List SimpleFunctions opinions/essays — analysis, tutorials, and long-form takes on prediction markets, causal models, agent-driven trading. |
| get_opinion | Get a single opinion/essay by slug. |
| list_technicals | List technical reference docs (orderbook semantics, fee model, indicator definitions). |
| get_technical | Get a single technical reference doc by slug. |
| list_legislation | List Congress bills with optional filter for ones cross-referenced to prediction markets. |
| list_congress_members | List sitting US Congress members. |
| get_congress_member | Get a single Congress member by bioguide ID. |
| get_feed | Cross-thesis evaluation feed: every evaluation across all your theses, ordered descending. Powers `sf feed` CLI. |
| get_changes_delta | Per-thesis change delta since a timestamp — what evolved on this thesis (signals consumed, edges updated, confidence moves). |
| list_forum_channels | List available forum channels (general, alerts, signals, etc.) the agent can read or post to. |
| 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. |
| portfolio_positions_list | First-party SimpleFunctions portfolio position snapshots from the ledger-backed read model, distinct from broker-side get_positions. |
| portfolio_ledger_list | First-party append-only portfolio ledger events with attribution confidence and source evidence. |
| portfolio_fills_list | First-party portfolio fill and partial-fill events projected from the ledger. |
| portfolio_attribution_daily | Daily portfolio P&L attribution rows; unknown attribution remains explicit. |
| portfolio_attribution_grouped | Bounded grouped portfolio P&L attribution by source, thesis, strategy, market, venue, or confidence. |
| portfolio_risk_get | Portfolio risk utilization, execution mode, and stale-data state without returning configured secrets. |
| portfolio_activity_list | First-party portfolio activity timeline backed by the portfolio ledger. |
| 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. |
| tts | Text-to-speech proxy. Returns audio bytes encoded as base64. |
| stt | Speech-to-text proxy. Pass base64-encoded audio, get transcribed text. |
| explore_theses | Browse public theses (alias of explore_public). Pass slug to get one, omit to list. |
| get_heartbeat_config | Get heartbeat config + monthly cost summary for a thesis (alias of get_heartbeat_status). |
| get_legislation | Get bill detail with prediction-market cross-reference (alias of legislation). |