io.github.spfunctions/simplefunctions

Official108 toolsLive

by spfunctions · TypeScript

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

io.github.spfunctions/simplefunctions (MCP Server)

This MCP server provides a calibrated “world model” for AI agents, focused on prediction-market infrastructure. It includes world-state and market tooling for inspection and structured exports. The dataset references Kalshi and Polymarket integrations, and positions the sf SimpleFunctions CLI as a source for live data via JSON commands.

🛠️ Key Features

“Calibrated world model” for AI agents
40 tools for world state, markets, and trading
Live state queries for Kalshi + Polymarket
Structured JSON outputs for agent coding workflows

🚀 Use Cases

Market and orderbook inspection
Trading-related workflows using prediction markets
Local interaction via SimpleFunctions CLI (sf)
Support for coding agents consuming JSON

⚡ Developer Benefits

CLI-first surface (sf) for a SimpleFunctions prediction-market workflow
Command examples include sf login, sf status --json, sf world --json, sf describe --all --json

⚠️ Limitations

Described as “40 tools” within the provided summary, while the reported toolCount is 108; exact tool granularity is not detailed.

Topics

ai-agentsedge-detectionkalshimcppolymarketprediction-marketstrading-clithesis-enginebacktestingkalshi-apikalshi-trading-botmarket-makingpolymarket-apipolymarket-trading-bottrading-botprediction-market-trading-botcli-firstsf-cliagent-ready-jsonsimplefunctions

Captured live from the server via tools/list.

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.

Parameters2

thesisId	string	optional	Thesis ID. Omit for global market snapshot on the free tier.
apiKey	string	optional	SimpleFunctions API key. Required only for thesis-specific context. Get one at https://simplefunctions.dev/dashboard/keys or run: sf login

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID. Omit for global market snapshot on the free tier.",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Required only for thesis-specific context. Get one at https://simplefunctions.dev/dashboard/keys or run: sf login",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_theses

List all theses for the authenticated user.

Parameters1

apiKey

string

required

SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

inject_signal

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

Parameters4

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
content	string	required	Signal content
type	string	optional	Signal type

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "content": {
      "description": "Signal content",
      "type": "string"
    },
    "type": {
      "description": "Signal type",
      "default": "user_note",
      "type": "string",
      "enum": [
        "news",
        "user_note",
        "external"
      ]
    }
  },
  "required": [
    "thesisId",
    "apiKey",
    "content"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

trigger_evaluation

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

Parameters2

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

query	string	optional	Keyword search (e.g. "oil recession")
series	string	optional	Kalshi series ticker (e.g. KXWTIMAX)
market	string	optional	Specific market ticker (e.g. KXWTIMAX-26DEC31-T140)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Keyword search (e.g. \"oil recession\")",
      "type": "string"
    },
    "series": {
      "description": "Kalshi series ticker (e.g. KXWTIMAX)",
      "type": "string"
    },
    "market": {
      "description": "Specific market ticker (e.g. KXWTIMAX-26DEC31-T140)",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
thesis	string	required	Your thesis statement
sync	boolean	optional	Wait for formation to complete

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "thesis": {
      "description": "Your thesis statement",
      "type": "string"
    },
    "sync": {
      "description": "Wait for formation to complete",
      "default": true,
      "type": "boolean"
    }
  },
  "required": [
    "apiKey",
    "thesis"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

explore_public

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

Parameters1

slug

string

optional

Specific thesis slug, or empty to list all

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Specific thesis slug, or empty to list all",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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).

Parameters1

topic

string

optional

Deep dive topic: energy, rates, fx, equities, crypto, volatility. Omit for core 5.

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Deep dive topic: energy, rates, fx, equities, crypto, volatility. Omit for core 5.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

symbols	string	required	Comma-separated symbols (max 5). Use .FUT for continuous futures. Examples: SPY, CL.FUT, ES.FUT, GLD
dataset	string	optional	DBEQ.BASIC (stocks/ETFs, default), GLBX.MDP3 (CME futures), OPRA.PILLAR (options), XNAS.BASIC (Nasdaq)
schema	string	optional	ohlcv-1d (default), ohlcv-1h, ohlcv-1m, trades, bbo-1s, bbo-1m, statistics, definition
stype	string	optional	raw_symbol (default) or continuous (for .FUT symbols)
days	number	optional	Lookback days (default 7, max 30)

Raw schema

{
  "type": "object",
  "properties": {
    "symbols": {
      "description": "Comma-separated symbols (max 5). Use .FUT for continuous futures. Examples: SPY, CL.FUT, ES.FUT, GLD",
      "type": "string"
    },
    "dataset": {
      "description": "DBEQ.BASIC (stocks/ETFs, default), GLBX.MDP3 (CME futures), OPRA.PILLAR (options), XNAS.BASIC (Nasdaq)",
      "type": "string"
    },
    "schema": {
      "description": "ohlcv-1d (default), ohlcv-1h, ohlcv-1m, trades, bbo-1s, bbo-1m, statistics, definition",
      "type": "string"
    },
    "stype": {
      "description": "raw_symbol (default) or continuous (for .FUT symbols)",
      "type": "string"
    },
    "days": {
      "description": "Lookback days (default 7, max 30)",
      "type": "number"
    }
  },
  "required": [
    "symbols"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

string

required

Natural language query (e.g. "iran oil prices", "fed rate cut 2026", "recession probability")

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Natural language query (e.g. \"iran oil prices\", \"fed rate cut 2026\", \"recession probability\")",
      "type": "string"
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters20

iy_min	number	optional	Minimum implied yield, annualized %. Try 200 for long-tail.
iy_max	number	optional
ee_min	number	optional	Minimum expected edge in cents (requires thesis or regime row).
las_max	number	optional	Maximum liquidity-adjusted spread (spread/mid). Try 0.05.
or_min	number	optional	Minimum event overround. 0.05 = 105¢ field (book-maker margin or arb).
or_max	number	optional
cri_max	number	optional	Maximum cliff risk = max(p,1-p)/min(p,1-p). 1=balanced, ∞=cliff.
cri_min	number	optional
tau_max_days	number	optional	Maximum days to expiry.
tau_min_days	number	optional
category	string	optional	crypto, political, financial, sports, etc — kalshi-supplied category from snapshot blob
venue	string	optional
keyword	string	optional	Substring filter on title.
has_thesis	boolean	optional	Only markets covered by an active public thesis.
no_thesis	boolean	optional	POSITIVE selector — only markets WITHOUT a thesis (unloved long tail).
has_orderbook	boolean	optional	Only markets with cached orderbook (last 6h regime row).
no_orderbook	boolean	optional	POSITIVE selector — only markets WITHOUT recent orderbook attention.
sort	string	optional	Sort field. Default: iy
order	string	optional	Default: desc
limit	number	optional	Default 50, max 200

Raw schema

{
  "type": "object",
  "properties": {
    "iy_min": {
      "description": "Minimum implied yield, annualized %. Try 200 for long-tail.",
      "type": "number"
    },
    "iy_max": {
      "type": "number"
    },
    "ee_min": {
      "description": "Minimum expected edge in cents (requires thesis or regime row).",
      "type": "number"
    },
    "las_max": {
      "description": "Maximum liquidity-adjusted spread (spread/mid). Try 0.05.",
      "type": "number"
    },
    "or_min": {
      "description": "Minimum event overround. 0.05 = 105¢ field (book-maker margin or arb).",
      "type": "number"
    },
    "or_max": {
      "type": "number"
    },
    "cri_max": {
      "description": "Maximum cliff risk = max(p,1-p)/min(p,1-p). 1=balanced, ∞=cliff.",
      "type": "number"
    },
    "cri_min": {
      "type": "number"
    },
    "tau_max_days": {
      "description": "Maximum days to expiry.",
      "type": "number"
    },
    "tau_min_days": {
      "type": "number"
    },
    "category": {
      "description": "crypto, political, financial, sports, etc — kalshi-supplied category from snapshot blob",
      "type": "string"
    },
    "venue": {
      "type": "string",
      "enum": [
        "kalshi",
        "polymarket"
      ]
    },
    "keyword": {
      "description": "Substring filter on title.",
      "type": "string"
    },
    "has_thesis": {
      "description": "Only markets covered by an active public thesis.",
      "type": "boolean"
    },
    "no_thesis": {
      "description": "POSITIVE selector — only markets WITHOUT a thesis (unloved long tail).",
      "type": "boolean"
    },
    "has_orderbook": {
      "description": "Only markets with cached orderbook (last 6h regime row).",
      "type": "boolean"
    },
    "no_orderbook": {
      "description": "POSITIVE selector — only markets WITHOUT recent orderbook attention.",
      "type": "boolean"
    },
    "sort": {
      "description": "Sort field. Default: iy",
      "type": "string",
      "enum": [
        "iy",
        "ee",
        "or",
        "las",
        "cri",
        "tau",
        "volume"
      ]
    },
    "order": {
      "description": "Default: desc",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Default 50, max 200",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters14

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
marketId	string	required	Market ticker e.g. KXWTIMAX-26DEC31-T150
market	string	required	Human-readable market name
direction	string	required	Trade direction
horizon	string	optional	Time horizon
entryBelow	number	optional	Entry trigger: ask <= this value (cents)
entryAbove	number	optional	Entry trigger: ask >= this value (cents, for NO direction)
stopLoss	number	optional	Stop loss: bid <= this value (cents)
takeProfit	number	optional	Take profit: bid >= this value (cents)
maxQuantity	number	optional	Max total contracts
perOrderQuantity	number	optional	Contracts per order
softConditions	string	optional	LLM-evaluated conditions
rationale	string	optional	Full logic description

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "marketId": {
      "description": "Market ticker e.g. KXWTIMAX-26DEC31-T150",
      "type": "string"
    },
    "market": {
      "description": "Human-readable market name",
      "type": "string"
    },
    "direction": {
      "description": "Trade direction",
      "type": "string",
      "enum": [
        "yes",
        "no"
      ]
    },
    "horizon": {
      "description": "Time horizon",
      "default": "medium",
      "type": "string",
      "enum": [
        "short",
        "medium",
        "long"
      ]
    },
    "entryBelow": {
      "description": "Entry trigger: ask <= this value (cents)",
      "type": "number"
    },
    "entryAbove": {
      "description": "Entry trigger: ask >= this value (cents, for NO direction)",
      "type": "number"
    },
    "stopLoss": {
      "description": "Stop loss: bid <= this value (cents)",
      "type": "number"
    },
    "takeProfit": {
      "description": "Take profit: bid >= this value (cents)",
      "type": "number"
    },
    "maxQuantity": {
      "description": "Max total contracts",
      "default": 500,
      "type": "number"
    },
    "perOrderQuantity": {
      "description": "Contracts per order",
      "default": 50,
      "type": "number"
    },
    "softConditions": {
      "description": "LLM-evaluated conditions",
      "type": "string"
    },
    "rationale": {
      "description": "Full logic description",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey",
    "marketId",
    "market",
    "direction"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_strategies

Advanced: List trading strategies for a thesis.

Parameters3

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
status	string	optional	Filter: active\|watching\|executed\|cancelled\|review

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "status": {
      "description": "Filter: active|watching|executed|cancelled|review",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

update_strategy

Advanced: Update a trading strategy (stop loss, take profit, status).

Parameters11

thesisId	string	required	Thesis ID
strategyId	string	required	Strategy ID (UUID)
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
stopLoss	number	optional	New stop loss (cents)
takeProfit	number	optional	New take profit (cents)
entryBelow	number	optional	New entry below trigger (cents)
entryAbove	number	optional	New entry above trigger (cents)
status	string	optional	New status: active\|watching\|executed\|cancelled\|review
priority	number	optional	New priority
softConditions	string	optional	Updated soft conditions
rationale	string	optional	Updated rationale

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "strategyId": {
      "description": "Strategy ID (UUID)",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "stopLoss": {
      "description": "New stop loss (cents)",
      "type": "number"
    },
    "takeProfit": {
      "description": "New take profit (cents)",
      "type": "number"
    },
    "entryBelow": {
      "description": "New entry below trigger (cents)",
      "type": "number"
    },
    "entryAbove": {
      "description": "New entry above trigger (cents)",
      "type": "number"
    },
    "status": {
      "description": "New status: active|watching|executed|cancelled|review",
      "type": "string"
    },
    "priority": {
      "description": "New priority",
      "type": "number"
    },
    "softConditions": {
      "description": "Updated soft conditions",
      "type": "string"
    },
    "rationale": {
      "description": "Updated rationale",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "strategyId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_milestones

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

Parameters2

hours	number	optional	Hours ahead to look (default 168 = 1 week)
category	string	optional	Filter by category (e.g. Economics, Politics, Sports)

Raw schema

{
  "type": "object",
  "properties": {
    "hours": {
      "description": "Hours ahead to look (default 168 = 1 week)",
      "default": 168,
      "type": "number"
    },
    "category": {
      "description": "Filter by category (e.g. Economics, Politics, Sports)",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_forecast

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

Parameters3

eventTicker	string	required	Kalshi event ticker (e.g. KXWTIMAX-26DEC31)
days	number	optional	Days of history (default 7)
apiKey	string	required	SimpleFunctions API key (needed for authenticated Kalshi calls). Get one at https://simplefunctions.dev/dashboard/keys

Raw schema

{
  "type": "object",
  "properties": {
    "eventTicker": {
      "description": "Kalshi event ticker (e.g. KXWTIMAX-26DEC31)",
      "type": "string"
    },
    "days": {
      "description": "Days of history (default 7)",
      "default": 7,
      "type": "number"
    },
    "apiKey": {
      "description": "SimpleFunctions API key (needed for authenticated Kalshi calls). Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    }
  },
  "required": [
    "eventTicker",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_settlements

Advanced: Settled contracts with realized P&L.

Parameters2

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
ticker	string	optional	Filter by market ticker

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "ticker": {
      "description": "Filter by market ticker",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_balance

Advanced: Kalshi account balance and portfolio value.

Parameters1

apiKey

string

required

SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_orders

Advanced: Current resting orders on Kalshi.

Parameters2

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
status	string	optional	Filter by status: resting, canceled, executed. Default: resting

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "status": {
      "description": "Filter by status: resting, canceled, executed. Default: resting",
      "default": "resting",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_schedule

Get exchange status and trading hours

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fills

Advanced: Recent trade fills on Kalshi.

Parameters2

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
ticker	string	optional	Filter by market ticker

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "ticker": {
      "description": "Filter by market ticker",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

what_if

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

Parameters3

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
overrides	object	required	Node probability overrides, e.g. {"n1": 0.1, "n3": 0.2}

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "overrides": {
      "description": "Node probability overrides, e.g. {\"n1\": 0.1, \"n3\": 0.2}",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "number"
      }
    }
  },
  "required": [
    "thesisId",
    "apiKey",
    "overrides"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

augment_tree

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

Parameters3

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
dryRun	boolean	optional	Preview without applying (default: false)

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "dryRun": {
      "description": "Preview without applying (default: false)",
      "type": "boolean"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters4

apiKey	string	optional	SimpleFunctions API key. Omit for public edges only.
limit	number	optional	Max edges to return
minEdge	number	optional	Minimum edge in cents
venue	string	optional	Filter: kalshi or polymarket

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Omit for public edges only.",
      "type": "string"
    },
    "limit": {
      "description": "Max edges to return",
      "default": 15,
      "type": "number"
    },
    "minEdge": {
      "description": "Minimum edge in cents",
      "default": 3,
      "type": "number"
    },
    "venue": {
      "description": "Filter: kalshi or polymarket",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

freshness	string	optional	Max cache age: 1h, 6h, 12h, 1d
category	string	optional	Filter: macro, geopolitics, crypto, policy, event
limit	number	optional	Max ideas (1-10)

Raw schema

{
  "type": "object",
  "properties": {
    "freshness": {
      "description": "Max cache age: 1h, 6h, 12h, 1d",
      "default": "12h",
      "type": "string"
    },
    "category": {
      "description": "Filter: macro, geopolitics, crypto, policy, event",
      "type": "string"
    },
    "limit": {
      "description": "Max ideas (1-10)",
      "default": 5,
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters15

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
action	string	required	Trade action
venue	string	required	Exchange venue
marketId	string	required	Market ticker (e.g. KXFEDDEC-25DEC31-T100)
marketTitle	string	required	Human-readable market name
direction	string	required	Contract direction
targetQuantity	number	required	Number of contracts
maxPrice	number	optional	Max price per contract in cents (1-99). Omit for market order.
triggerType	string	optional	When to execute
triggerPrice	number	optional	Price trigger threshold in cents (for price_below/price_above)
expireAt	string	optional	ISO timestamp when intent expires (default: +24h)
rationale	string	optional	Why this trade — logged for audit trail
autoExecute	boolean	optional	Auto-execute without later human confirmation. Defaults to false unless explicitly set true.
source	string	optional	Intent source: agent, manual, idea
sourceId	string	optional	Source reference (idea ID, thesis ID, etc.)

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "action": {
      "description": "Trade action",
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "venue": {
      "description": "Exchange venue",
      "type": "string",
      "enum": [
        "kalshi",
        "polymarket"
      ]
    },
    "marketId": {
      "description": "Market ticker (e.g. KXFEDDEC-25DEC31-T100)",
      "type": "string"
    },
    "marketTitle": {
      "description": "Human-readable market name",
      "type": "string"
    },
    "direction": {
      "description": "Contract direction",
      "type": "string",
      "enum": [
        "yes",
        "no"
      ]
    },
    "targetQuantity": {
      "description": "Number of contracts",
      "type": "number"
    },
    "maxPrice": {
      "description": "Max price per contract in cents (1-99). Omit for market order.",
      "type": "number"
    },
    "triggerType": {
      "description": "When to execute",
      "default": "immediate",
      "type": "string",
      "enum": [
        "immediate",
        "price_below",
        "price_above",
        "time"
      ]
    },
    "triggerPrice": {
      "description": "Price trigger threshold in cents (for price_below/price_above)",
      "type": "number"
    },
    "expireAt": {
      "description": "ISO timestamp when intent expires (default: +24h)",
      "type": "string"
    },
    "rationale": {
      "description": "Why this trade — logged for audit trail",
      "type": "string"
    },
    "autoExecute": {
      "description": "Auto-execute without later human confirmation. Defaults to false unless explicitly set true.",
      "default": false,
      "type": "boolean"
    },
    "source": {
      "description": "Intent source: agent, manual, idea",
      "default": "agent",
      "type": "string"
    },
    "sourceId": {
      "description": "Source reference (idea ID, thesis ID, etc.)",
      "type": "string"
    }
  },
  "required": [
    "apiKey",
    "action",
    "venue",
    "marketId",
    "marketTitle",
    "direction",
    "targetQuantity"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_intents

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

Parameters3

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
status	string	optional	Filter: pending, armed, triggered, executing, partial, filled, expired, cancelled, rejected
activeOnly	boolean	optional	Only show active intents (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "status": {
      "description": "Filter: pending, armed, triggered, executing, partial, filled, expired, cancelled, rejected",
      "type": "string"
    },
    "activeOnly": {
      "description": "Only show active intents (default true)",
      "default": true,
      "type": "boolean"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_intent

Cancel an active intent. Stops trigger evaluation and prevents execution.

Parameters2

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
intentId	string	required	Intent ID to cancel

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "intentId": {
      "description": "Intent ID to cancel",
      "type": "string"
    }
  },
  "required": [
    "apiKey",
    "intentId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

query	string	required	Search query (e.g. "iran oil", "hormuz shipping")
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
mode	string	optional	raw = structured JSON, summary = LLM synthesis
hours	number	optional	Hours to search back (default 24)
limit	number	optional	Max posts to return (default 20)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query (e.g. \"iran oil\", \"hormuz shipping\")",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "mode": {
      "description": "raw = structured JSON, summary = LLM synthesis",
      "default": "raw",
      "type": "string",
      "enum": [
        "raw",
        "summary"
      ]
    },
    "hours": {
      "description": "Hours to search back (default 24)",
      "default": 24,
      "type": "number"
    },
    "limit": {
      "description": "Max posts to return (default 20)",
      "default": 20,
      "type": "number"
    }
  },
  "required": [
    "query",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

x_volume

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

Parameters4

query	string	required	Search query
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
hours	number	optional	Hours to look back (default 72)
granularity	string	optional	Timeseries granularity

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "hours": {
      "description": "Hours to look back (default 72)",
      "default": 72,
      "type": "number"
    },
    "granularity": {
      "description": "Timeseries granularity",
      "default": "hour",
      "type": "string",
      "enum": [
        "minute",
        "hour",
        "day"
      ]
    }
  },
  "required": [
    "query",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

x_news

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

Parameters3

query	string	required	News search query
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
limit	number	optional	Max stories (default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "News search query",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "limit": {
      "description": "Max stories (default 10)",
      "default": 10,
      "type": "number"
    }
  },
  "required": [
    "query",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

x_account

Advanced: Recent posts from a specific X/Twitter account.

Parameters4

username	string	required	X/Twitter username (without @)
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
hours	number	optional	Hours to look back (default 24)
limit	number	optional	Max posts (default 20)

Raw schema

{
  "type": "object",
  "properties": {
    "username": {
      "description": "X/Twitter username (without @)",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "hours": {
      "description": "Hours to look back (default 24)",
      "default": 24,
      "type": "number"
    },
    "limit": {
      "description": "Max posts (default 20)",
      "default": 20,
      "type": "number"
    }
  },
  "required": [
    "username",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters9

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
newsIntervalMin	number	optional	News scan interval in minutes (15-1440, default 240)
xIntervalMin	number	optional	X/social scan interval in minutes (60-1440, default 240)
evalModelTier	string	optional	LLM model for evaluations
monthlyBudgetUsd	number	optional	Monthly budget cap in USD (0 = unlimited)
paused	boolean	optional	Pause/resume heartbeat
closedLoopEntry	boolean	optional	Enable/disable closed-loop entry intent creation
closedLoopExit	boolean	optional	Enable/disable closed-loop exit intent creation

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "newsIntervalMin": {
      "description": "News scan interval in minutes (15-1440, default 240)",
      "type": "number"
    },
    "xIntervalMin": {
      "description": "X/social scan interval in minutes (60-1440, default 240)",
      "type": "number"
    },
    "evalModelTier": {
      "description": "LLM model for evaluations",
      "type": "string",
      "enum": [
        "cheap",
        "base",
        "medium",
        "heavy"
      ]
    },
    "monthlyBudgetUsd": {
      "description": "Monthly budget cap in USD (0 = unlimited)",
      "type": "number"
    },
    "paused": {
      "description": "Pause/resume heartbeat",
      "type": "boolean"
    },
    "closedLoopEntry": {
      "description": "Enable/disable closed-loop entry intent creation",
      "type": "boolean"
    },
    "closedLoopExit": {
      "description": "Enable/disable closed-loop exit intent creation",
      "type": "boolean"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

update_thesis

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

Parameters5

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
title	string	optional	New thesis title
status	string	optional	New status: active, paused, archived
webhookUrl	string	optional	Webhook URL for confidence change notifications (HTTPS only)

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "title": {
      "description": "New thesis title",
      "type": "string"
    },
    "status": {
      "description": "New status: active, paused, archived",
      "type": "string"
    },
    "webhookUrl": {
      "description": "Webhook URL for confidence change notifications (HTTPS only)",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

add_position

Record a new position in a thesis for tracking. Use after an intent fills or a manual trade.

Parameters9

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
venue	string	required	Exchange venue
externalMarketId	string	required	Market ticker
marketTitle	string	required	Human-readable market name
direction	string	required	Position direction
entryPrice	number	required	Entry price in cents
size	number	optional	Position size (contracts)
rationale	string	optional	Why this position

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "venue": {
      "description": "Exchange venue",
      "type": "string",
      "enum": [
        "kalshi",
        "polymarket"
      ]
    },
    "externalMarketId": {
      "description": "Market ticker",
      "type": "string"
    },
    "marketTitle": {
      "description": "Human-readable market name",
      "type": "string"
    },
    "direction": {
      "description": "Position direction",
      "type": "string",
      "enum": [
        "yes",
        "no"
      ]
    },
    "entryPrice": {
      "description": "Entry price in cents",
      "type": "number"
    },
    "size": {
      "description": "Position size (contracts)",
      "type": "number"
    },
    "rationale": {
      "description": "Why this position",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey",
    "venue",
    "externalMarketId",
    "marketTitle",
    "direction",
    "entryPrice"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

update_position

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

Parameters8

thesisId	string	required	Thesis ID
positionId	string	required	Position ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
currentPrice	number	optional	Current market price in cents
edge	number	optional	Current edge in cents
size	number	optional	Updated size
status	string	optional	open or closed
rationale	string	optional	Updated rationale

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "positionId": {
      "description": "Position ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "currentPrice": {
      "description": "Current market price in cents",
      "type": "number"
    },
    "edge": {
      "description": "Current edge in cents",
      "type": "number"
    },
    "size": {
      "description": "Updated size",
      "type": "number"
    },
    "status": {
      "description": "open or closed",
      "type": "string"
    },
    "rationale": {
      "description": "Updated rationale",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "positionId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

close_position

Delete a position record from a thesis.

Parameters3

thesisId	string	required	Thesis ID
positionId	string	required	Position ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "positionId": {
      "description": "Position ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "positionId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_evaluation_history

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

Parameters2

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters4

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
updates	array	required	Node updates to apply
lock	array	optional	Advisory pin — tells future evaluations that these nodes are well-supported. Evidence can still revise them; pinning no longer makes a node permanent.

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "updates": {
      "description": "Node updates to apply",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "nodeId": {
            "description": "Causal tree node ID (e.g. n3, n1.2)",
            "type": "string"
          },
          "probability": {
            "description": "New probability (0-1). Use 0.99 for confirmed facts.",
            "type": "number"
          },
          "reason": {
            "description": "Why this update",
            "type": "string"
          }
        },
        "required": [
          "nodeId",
          "probability"
        ]
      }
    },
    "lock": {
      "description": "Advisory pin — tells future evaluations that these nodes are well-supported. Evidence can still revise them; pinning no longer makes a node permanent.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "thesisId",
    "apiKey",
    "updates"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_heartbeat_status

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

Parameters2

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
source	object	required
analysis	object	optional	LLM analysis of scraped content
enrich	object	optional	Cross-reference with prediction markets
webhook	object	optional	Push results to a webhook

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "source": {
      "type": "object",
      "properties": {
        "action": {
          "description": "Firecrawl action",
          "type": "string",
          "enum": [
            "scrape",
            "crawl",
            "search",
            "map",
            "extract",
            "batch_scrape"
          ]
        },
        "url": {
          "description": "URL to scrape/crawl/map/extract",
          "type": "string"
        },
        "urls": {
          "description": "URLs for batch_scrape or extract",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "query": {
          "description": "Search query (for search action)",
          "type": "string"
        },
        "options": {
          "description": "Full Firecrawl passthrough options",
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        }
      },
      "required": [
        "action"
      ]
    },
    "analysis": {
      "description": "LLM analysis of scraped content",
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean"
        },
        "model": {
          "description": "Any OpenRouter model ID. Default: google/gemini-2.5-flash",
          "type": "string"
        },
        "prompt": {
          "description": "What to analyze in the scraped content",
          "type": "string"
        },
        "schema": {
          "description": "JSON Schema for structured output",
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {}
        },
        "temperature": {
          "type": "number"
        }
      },
      "required": [
        "enabled",
        "prompt"
      ]
    },
    "enrich": {
      "description": "Cross-reference with prediction markets",
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean"
        },
        "topics": {
          "description": "Topics to search in prediction markets",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "includeIndex": {
          "type": "boolean"
        },
        "venues": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "kalshi",
              "polymarket"
            ]
          }
        },
        "limit": {
          "type": "number"
        }
      },
      "required": [
        "enabled",
        "topics"
      ]
    },
    "webhook": {
      "description": "Push results to a webhook",
      "type": "object",
      "properties": {
        "url": {
          "description": "HTTPS webhook URL",
          "type": "string"
        },
        "format": {
          "type": "string",
          "enum": [
            "full",
            "brief",
            "tweetable"
          ]
        },
        "headers": {
          "type": "object",
          "propertyNames": {
            "type": "string"
          },
          "additionalProperties": {
            "type": "string"
          }
        },
        "secret": {
          "description": "HMAC-SHA256 signing secret",
          "type": "string"
        }
      },
      "required": [
        "url"
      ]
    }
  },
  "required": [
    "apiKey",
    "source"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters4

content	string	required	Text content to cross-reference (up to 50K chars)
topics	array	required	Topics to search in prediction markets, e.g. ["iran", "oil"]
model	string	optional	LLM model for digest generation. Default: google/gemini-2.5-flash
includeIndex	boolean	optional	Include SimpleFunctions Index

Raw schema

{
  "type": "object",
  "properties": {
    "content": {
      "description": "Text content to cross-reference (up to 50K chars)",
      "type": "string"
    },
    "topics": {
      "description": "Topics to search in prediction markets, e.g. [\"iran\", \"oil\"]",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "model": {
      "description": "LLM model for digest generation. Default: google/gemini-2.5-flash",
      "type": "string"
    },
    "includeIndex": {
      "description": "Include SimpleFunctions Index",
      "type": "boolean"
    }
  },
  "required": [
    "content",
    "topics"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_skill

Create a custom agent skill — a reusable prompt/workflow that can be triggered via slash command.

Parameters10

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
name	string	required	Skill name (e.g. "precheck")
trigger	string	required	Slash command trigger (e.g. "/precheck")
description	string	required	What this skill does
prompt	string	required	The full prompt/instructions for the skill
category	string	optional	Category: custom, trading, research, monitoring
tags	array	optional	Tags for discovery
toolsUsed	array	optional	SimpleFunctions tools this skill uses
estimatedTime	string	optional	Estimated run time
auto	string	optional	Auto-trigger condition

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "name": {
      "description": "Skill name (e.g. \"precheck\")",
      "type": "string"
    },
    "trigger": {
      "description": "Slash command trigger (e.g. \"/precheck\")",
      "type": "string"
    },
    "description": {
      "description": "What this skill does",
      "type": "string"
    },
    "prompt": {
      "description": "The full prompt/instructions for the skill",
      "type": "string"
    },
    "category": {
      "description": "Category: custom, trading, research, monitoring",
      "type": "string"
    },
    "tags": {
      "description": "Tags for discovery",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "toolsUsed": {
      "description": "SimpleFunctions tools this skill uses",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "estimatedTime": {
      "description": "Estimated run time",
      "type": "string"
    },
    "auto": {
      "description": "Auto-trigger condition",
      "type": "string"
    }
  },
  "required": [
    "apiKey",
    "name",
    "trigger",
    "description",
    "prompt"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_skills

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

Parameters1

apiKey

string

required

SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

run_skill

Get a skill by ID or trigger to run it. Returns the skill prompt and metadata.

Parameters2

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
skillId	string	required	Skill ID (UUID) to retrieve

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "skillId": {
      "description": "Skill ID (UUID) to retrieve",
      "type": "string"
    }
  },
  "required": [
    "apiKey",
    "skillId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

publish_skill

Publish a skill to make it publicly browsable and forkable.

Parameters3

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
skillId	string	required	Skill ID to publish
slug	string	required	Public URL slug (3-60 chars, lowercase, numbers, hyphens)

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "skillId": {
      "description": "Skill ID to publish",
      "type": "string"
    },
    "slug": {
      "description": "Public URL slug (3-60 chars, lowercase, numbers, hyphens)",
      "type": "string"
    }
  },
  "required": [
    "apiKey",
    "skillId",
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

fork_skill

Fork a public skill into your collection. No slug needed — just the skill ID.

Parameters2

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
skillId	string	required	Public skill ID to fork

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "skillId": {
      "description": "Public skill ID to fork",
      "type": "string"
    }
  },
  "required": [
    "apiKey",
    "skillId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

browse_public_skills

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

Parameters3

category	string	optional	Filter by category: custom, trading, research, monitoring
q	string	optional	Search skills by name/description
sort	string	optional	Sort order: popular or new (default: new)

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Filter by category: custom, trading, research, monitoring",
      "type": "string"
    },
    "q": {
      "description": "Search skills by name/description",
      "type": "string"
    },
    "sort": {
      "description": "Sort order: popular or new (default: new)",
      "type": "string",
      "enum": [
        "popular",
        "new"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters6

apiKey	string	required	SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys
idOrSlug	string	required	Thesis ID or public slug
newRawThesis	string	optional	Evolve mode: new frame in 1-3 sentences. Omit for clone mode.
newTitle	string	optional	Evolve mode: short title for the new thesis, ≤60 chars
reason	string	optional	Evolve mode: why the original frame is no longer adequate
inheritEdgeMarketIds	array	optional	Evolve mode: subset of current edge marketIds to carry over. Omit to let formation rescan fresh.

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Get one at https://simplefunctions.dev/dashboard/keys",
      "type": "string"
    },
    "idOrSlug": {
      "description": "Thesis ID or public slug",
      "type": "string"
    },
    "newRawThesis": {
      "description": "Evolve mode: new frame in 1-3 sentences. Omit for clone mode.",
      "type": "string"
    },
    "newTitle": {
      "description": "Evolve mode: short title for the new thesis, ≤60 chars",
      "type": "string"
    },
    "reason": {
      "description": "Evolve mode: why the original frame is no longer adequate",
      "type": "string"
    },
    "inheritEdgeMarketIds": {
      "description": "Evolve mode: subset of current edge marketIds to carry over. Omit to let formation rescan fresh.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "apiKey",
    "idOrSlug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

focus	string	optional	Comma-separated topics for deeper coverage: geopolitics, economy, energy, elections, crypto, tech. Same token budget concentrated on fewer topics.
format	string	optional	Output format. markdown (default) is optimized for LLM context.

Raw schema

{
  "type": "object",
  "properties": {
    "focus": {
      "description": "Comma-separated topics for deeper coverage: geopolitics, economy, energy, elections, crypto, tech. Same token budget concentrated on fewer topics.",
      "type": "string"
    },
    "format": {
      "description": "Output format. markdown (default) is optimized for LLM context.",
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

since	string	required	Relative (30m, 1h, 6h, 24h) or ISO timestamp
format	string	optional	Output format

Raw schema

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Relative (30m, 1h, 6h, 24h) or ISO timestamp",
      "type": "string"
    },
    "format": {
      "description": "Output format",
      "default": "markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    }
  },
  "required": [
    "since"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters5

apiKey	string	required	SimpleFunctions API key
channel	string	optional	Channel: signals, edges, analysis, coordination, general
ticker	string	optional	Filter by ticker
since	string	optional	ISO cursor
limit	number	optional

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "channel": {
      "description": "Channel: signals, edges, analysis, coordination, general",
      "type": "string"
    },
    "ticker": {
      "description": "Filter by ticker",
      "type": "string"
    },
    "since": {
      "description": "ISO cursor",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "type": "number"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

post_to_forum

Post a message to the agent forum. Share discoveries, edges, coordination signals with other agents.

Parameters7

apiKey	string	required	SimpleFunctions API key
channel	string	required
type	string	required
content	string	required	1-3 sentence summary
tickers	array	optional	Related tickers
agentName	string	optional	Your agent name
replyTo	string	optional	Message ID to reply to

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "channel": {
      "type": "string",
      "enum": [
        "signals",
        "edges",
        "analysis",
        "coordination",
        "general"
      ]
    },
    "type": {
      "type": "string",
      "enum": [
        "signal",
        "edge",
        "analysis",
        "coordination",
        "request",
        "reply"
      ]
    },
    "content": {
      "description": "1-3 sentence summary",
      "type": "string",
      "maxLength": 2000
    },
    "tickers": {
      "description": "Related tickers",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "agentName": {
      "description": "Your agent name",
      "type": "string"
    },
    "replyTo": {
      "description": "Message ID to reply to",
      "type": "string"
    }
  },
  "required": [
    "apiKey",
    "channel",
    "type",
    "content"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

subscribe_forum

Subscribe to forum channels to receive messages in your inbox.

Parameters2

apiKey	string	required	SimpleFunctions API key
channels	array	required	Channel IDs to subscribe to

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "channels": {
      "description": "Channel IDs to subscribe to",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "apiKey",
    "channels"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

query_gov

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

Parameters2

q	string	required	Search query (e.g., "save act", "fed chair nomination")
mode	string	optional	raw = skip LLM synthesis, full = include answer

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Search query (e.g., \"save act\", \"fed chair nomination\")",
      "type": "string"
    },
    "mode": {
      "description": "raw = skip LLM synthesis, full = include answer",
      "default": "full",
      "type": "string",
      "enum": [
        "raw",
        "full"
      ]
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

query_econ

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

Parameters3

q	string	required	Economic query, e.g. "unemployment rate", "core CPI", "fed funds rate"
mode	string	optional	raw = structured series only, full = include answer
includeMarkets	boolean	optional	Attach related Kalshi/Polymarket markets. Default false.

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Economic query, e.g. \"unemployment rate\", \"core CPI\", \"fed funds rate\"",
      "type": "string"
    },
    "mode": {
      "description": "raw = structured series only, full = include answer",
      "default": "full",
      "type": "string",
      "enum": [
        "raw",
        "full"
      ]
    },
    "includeMarkets": {
      "description": "Attach related Kalshi/Polymarket markets. Default false.",
      "default": false,
      "type": "boolean"
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

legislation

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

Parameters1

billId

string

required

Bill ID, e.g. "119-hr-22"

Raw schema

{
  "type": "object",
  "properties": {
    "billId": {
      "description": "Bill ID, e.g. \"119-hr-22\"",
      "type": "string"
    }
  },
  "required": [
    "billId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters6

ticker	string	required	Market ticker, e.g. KXFEDDECISION-26DEC10-T0
format	string	optional	Default markdown
depth	boolean	optional	Include live orderbook depth. Default false for cheaper cached agent sweeps.
contagion	boolean	optional	Include contagion signals (default true)
diff	boolean	optional	Include market diff vs prior window (default true)
trend	boolean	optional	Include microstructure history (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "description": "Market ticker, e.g. KXFEDDECISION-26DEC10-T0",
      "type": "string"
    },
    "format": {
      "description": "Default markdown",
      "type": "string",
      "enum": [
        "markdown",
        "json"
      ]
    },
    "depth": {
      "description": "Include live orderbook depth. Default false for cheaper cached agent sweeps.",
      "default": false,
      "type": "boolean"
    },
    "contagion": {
      "description": "Include contagion signals (default true)",
      "type": "boolean"
    },
    "diff": {
      "description": "Include market diff vs prior window (default true)",
      "type": "boolean"
    },
    "trend": {
      "description": "Include microstructure history (default true)",
      "type": "boolean"
    }
  },
  "required": [
    "ticker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

ticker	string	required	Market ticker
depth	number	optional	Orderbook depth levels to include (0 = none)

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "description": "Market ticker",
      "type": "string"
    },
    "depth": {
      "description": "Orderbook depth levels to include (0 = none)",
      "type": "number"
    }
  },
  "required": [
    "ticker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_history

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

Parameters1

ticker

string

required

Market ticker

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "description": "Market ticker",
      "type": "string"
    }
  },
  "required": [
    "ticker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_microstructure_history

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

Parameters3

ticker	string	required	Market ticker
days	number	optional	Lookback days (default 7)
interval	string	optional	Bucketing

Raw schema

{
  "type": "object",
  "properties": {
    "ticker": {
      "description": "Market ticker",
      "type": "string"
    },
    "days": {
      "description": "Lookback days (default 7)",
      "type": "number"
    },
    "interval": {
      "description": "Bucketing",
      "type": "string",
      "enum": [
        "hour",
        "day"
      ]
    }
  },
  "required": [
    "ticker"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

batch_markets

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

Parameters2

tickers	string	required	Comma-separated tickers
depth	number	optional	Orderbook depth levels (0 = none)

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "description": "Comma-separated tickers",
      "type": "string"
    },
    "depth": {
      "description": "Orderbook depth levels (0 = none)",
      "type": "number"
    }
  },
  "required": [
    "tickers"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

tickers	string	required	Comma-separated tickers
sort	string	optional	Indicator to sort by (e.g. iy, cri, ee, las, overround)
order	string	optional	Sort order

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "description": "Comma-separated tickers",
      "type": "string"
    },
    "sort": {
      "description": "Indicator to sort by (e.g. iy, cri, ee, las, overround)",
      "type": "string"
    },
    "order": {
      "description": "Sort order",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    }
  },
  "required": [
    "tickers"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_index_history

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

Parameters1

days

number

optional

Lookback days (default 7)

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Lookback days (default 7)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_regime_scan

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

Parameters7

label	string	optional	Regime label filter
venue	string	optional	kalshi or polymarket
eventType	string	optional	binary, scalar, ladder
hasEdge	boolean	optional	Filter to markets with non-trivial SimpleFunctions edge
sort	string	optional	Sort field (e.g. as, score)
order	string	optional	Sort order
limit	number	optional	Max rows (default 50)

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "description": "Regime label filter",
      "type": "string"
    },
    "venue": {
      "description": "kalshi or polymarket",
      "type": "string"
    },
    "eventType": {
      "description": "binary, scalar, ladder",
      "type": "string"
    },
    "hasEdge": {
      "description": "Filter to markets with non-trivial SimpleFunctions edge",
      "type": "boolean"
    },
    "sort": {
      "description": "Sort field (e.g. as, score)",
      "type": "string"
    },
    "order": {
      "description": "Sort order",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Max rows (default 50)",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

topic	string	optional	Topic keyword (fed, election, ai)
window	string	optional	Lookback (e.g. 24h, 7d)

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Topic keyword (fed, election, ai)",
      "type": "string"
    },
    "window": {
      "description": "Lookback (e.g. 24h, 7d)",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_diff

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

Parameters4

tickers	string	optional	Comma-separated tickers
topic	string	optional	Topic keyword if no tickers
window	string	optional	Lookback (default 24h)
sort	string	optional	Sort field (e.g. priceDelta)

Raw schema

{
  "type": "object",
  "properties": {
    "tickers": {
      "description": "Comma-separated tickers",
      "type": "string"
    },
    "topic": {
      "description": "Topic keyword if no tickers",
      "type": "string"
    },
    "window": {
      "description": "Lookback (default 24h)",
      "type": "string"
    },
    "sort": {
      "description": "Sort field (e.g. priceDelta)",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_highlights

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_briefing

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

Parameters2

topic	string	optional	Topic keyword
window	string	optional	Lookback window

Raw schema

{
  "type": "object",
  "properties": {
    "topic": {
      "description": "Topic keyword",
      "type": "string"
    },
    "window": {
      "description": "Lookback window",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_calendar

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

Parameters2

days	number	optional	Lookahead days (default 30)
category	string	optional	Category filter (econ, election, sports, geo)

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Lookahead days (default 30)",
      "type": "number"
    },
    "category": {
      "description": "Category filter (econ, election, sports, geo)",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_economic_anchors

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

Parameters2

category	string	optional	Category (rates, inflation, employment, growth)
series	string	optional	FRED series ID (e.g. CPIAUCSL)

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Category (rates, inflation, employment, growth)",
      "type": "string"
    },
    "series": {
      "description": "FRED series ID (e.g. CPIAUCSL)",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters3

venue	string	optional	kalshi or polymarket
limit	number	optional	Max events
minPoints	number	optional	Minimum curve points to keep an event

Raw schema

{
  "type": "object",
  "properties": {
    "venue": {
      "description": "kalshi or polymarket",
      "type": "string"
    },
    "limit": {
      "description": "Max events",
      "type": "number"
    },
    "minPoints": {
      "description": "Minimum curve points to keep an event",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_yield_curve

Single yield curve for one event series.

Parameters2

event	string	required	Event ticker (e.g. KXFEDDECISION-26DEC10)
venue	string	optional	Venue if needed to disambiguate

Raw schema

{
  "type": "object",
  "properties": {
    "event": {
      "description": "Event ticker (e.g. KXFEDDECISION-26DEC10)",
      "type": "string"
    },
    "venue": {
      "description": "Venue if needed to disambiguate",
      "type": "string"
    }
  },
  "required": [
    "event"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_newmarkets

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

Parameters4

hours	number	optional	Lookback hours (default 24)
venue	string	optional	kalshi or polymarket
minLiquidity	number	optional	Minimum liquidity threshold
limit	number	optional	Max rows

Raw schema

{
  "type": "object",
  "properties": {
    "hours": {
      "description": "Lookback hours (default 24)",
      "type": "number"
    },
    "venue": {
      "description": "kalshi or polymarket",
      "type": "string"
    },
    "minLiquidity": {
      "description": "Minimum liquidity threshold",
      "type": "number"
    },
    "limit": {
      "description": "Max rows",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_calibration

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

Parameters2

category	string	optional	Topic filter (fed, elections, ai, crypto, sports, ...)
period	string	optional	Period (30d, 90d, all)

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Topic filter (fed, elections, ai, crypto, sports, ...)",
      "type": "string"
    },
    "period": {
      "description": "Period (30d, 90d, all)",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_answer

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

Parameters1

slug

string

required

Answer slug (e.g. will-the-fed-cut-rates-in-december)

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Answer slug (e.g. will-the-fed-cut-rates-in-december)",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

intent	string	optional	Workflow intent
q	string	optional	Specific question to scope the guide

Raw schema

{
  "type": "object",
  "properties": {
    "intent": {
      "description": "Workflow intent",
      "type": "string",
      "enum": [
        "query",
        "monitor",
        "integrate"
      ]
    },
    "q": {
      "description": "Specific question to scope the guide",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

site_search

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

Parameters1

string

required

Query

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Query",
      "type": "string"
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_changes

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

Parameters3

since	string	optional	ISO timestamp lower bound
q	string	optional	Keyword filter
type	string	optional	Change type

Raw schema

{
  "type": "object",
  "properties": {
    "since": {
      "description": "ISO timestamp lower bound",
      "type": "string"
    },
    "q": {
      "description": "Keyword filter",
      "type": "string"
    },
    "type": {
      "description": "Change type",
      "type": "string",
      "enum": [
        "new_contract",
        "price_move",
        "removed_contract"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_skills

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

Parameters1

apiKey

string

required

SimpleFunctions API key

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_public_skill

Get a single published skill by slug.

Parameters1

slug

string

required

Public skill slug

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Public skill slug",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_glossary

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

Parameters2

category	string	optional	Category filter
q	string	optional	Keyword

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Category filter",
      "type": "string"
    },
    "q": {
      "description": "Keyword",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_glossary_term

Get a single glossary term with full definition and links.

Parameters1

slug

string

required

Glossary slug

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Glossary slug",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_opinions

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

Parameters2

category	string	optional	Category filter
limit	number	optional	Max rows

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Category filter",
      "type": "string"
    },
    "limit": {
      "description": "Max rows",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_opinion

Get a single opinion/essay by slug.

Parameters1

slug

string

required

Opinion slug

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Opinion slug",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_technicals

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

Parameters2

category	string	optional	Category filter
limit	number	optional	Max rows

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "description": "Category filter",
      "type": "string"
    },
    "limit": {
      "description": "Max rows",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_technical

Get a single technical reference doc by slug.

Parameters1

slug

string

required

Technical doc slug

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Technical doc slug",
      "type": "string"
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_legislation

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

Parameters4

congress	string	optional	Congress number (e.g. 119)
hasMarket	boolean	optional	Only bills with a linked market
q	string	optional	Keyword
limit	number	optional	Max rows

Raw schema

{
  "type": "object",
  "properties": {
    "congress": {
      "description": "Congress number (e.g. 119)",
      "type": "string"
    },
    "hasMarket": {
      "description": "Only bills with a linked market",
      "type": "boolean"
    },
    "q": {
      "description": "Keyword",
      "type": "string"
    },
    "limit": {
      "description": "Max rows",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_congress_members

List sitting US Congress members.

Parameters4

chamber	string	optional	Chamber filter
state	string	optional	Two-letter state code
currentMember	boolean	optional	Only currently-serving members
limit	number	optional	Max rows

Raw schema

{
  "type": "object",
  "properties": {
    "chamber": {
      "description": "Chamber filter",
      "type": "string",
      "enum": [
        "house",
        "senate"
      ]
    },
    "state": {
      "description": "Two-letter state code",
      "type": "string"
    },
    "currentMember": {
      "description": "Only currently-serving members",
      "type": "boolean"
    },
    "limit": {
      "description": "Max rows",
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_congress_member

Get a single Congress member by bioguide ID.

Parameters1

string

required

Bioguide ID

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Bioguide ID",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_feed

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

Parameters3

apiKey	string	required	SimpleFunctions API key
hours	number	optional	Lookback hours (default 24)
limit	number	optional	Max rows

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "hours": {
      "description": "Lookback hours (default 24)",
      "type": "number"
    },
    "limit": {
      "description": "Max rows",
      "type": "number"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_changes_delta

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

Parameters3

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key
since	string	optional	ISO timestamp lower bound

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "since": {
      "description": "ISO timestamp lower bound",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_forum_channels

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

Parameters1

apiKey

string

required

SimpleFunctions API key

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

apiKey

string

required

SimpleFunctions API key. Requires Kalshi credentials configured via sf setup.

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key. Requires Kalshi credentials configured via sf setup.",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

portfolio_positions_list

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

Parameters10

apiKey	string	required	SimpleFunctions API key
limit	number	optional	Max rows
since	string	optional	ISO lower bound
until	string	optional	ISO upper bound
cursor	string	optional	Pagination cursor
venue	string	optional
marketId	string	optional
source	string	optional
thesisId	string	optional
confidence	string	optional	Attribution confidence such as exact, low, or unknown

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "limit": {
      "description": "Max rows",
      "type": "number"
    },
    "since": {
      "description": "ISO lower bound",
      "type": "string"
    },
    "until": {
      "description": "ISO upper bound",
      "type": "string"
    },
    "cursor": {
      "description": "Pagination cursor",
      "type": "string"
    },
    "venue": {
      "type": "string"
    },
    "marketId": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "thesisId": {
      "type": "string"
    },
    "confidence": {
      "description": "Attribution confidence such as exact, low, or unknown",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

portfolio_ledger_list

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

Parameters11

apiKey	string	required	SimpleFunctions API key
limit	number	optional
since	string	optional
until	string	optional
cursor	string	optional
eventType	string	optional
venue	string	optional
marketId	string	optional
source	string	optional
thesisId	string	optional
confidence	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "since": {
      "type": "string"
    },
    "until": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "eventType": {
      "type": "string"
    },
    "venue": {
      "type": "string"
    },
    "marketId": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "thesisId": {
      "type": "string"
    },
    "confidence": {
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

portfolio_fills_list

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

Parameters10

apiKey	string	required	SimpleFunctions API key
limit	number	optional
since	string	optional
until	string	optional
cursor	string	optional
venue	string	optional
marketId	string	optional
source	string	optional
thesisId	string	optional
confidence	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "since": {
      "type": "string"
    },
    "until": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "venue": {
      "type": "string"
    },
    "marketId": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "thesisId": {
      "type": "string"
    },
    "confidence": {
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

portfolio_attribution_daily

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

Parameters10

apiKey	string	required	SimpleFunctions API key
limit	number	optional
from	string	optional	YYYY-MM-DD
to	string	optional	YYYY-MM-DD
cursor	string	optional
venue	string	optional
marketId	string	optional
source	string	optional
thesisId	string	optional
confidence	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "from": {
      "description": "YYYY-MM-DD",
      "type": "string"
    },
    "to": {
      "description": "YYYY-MM-DD",
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "venue": {
      "type": "string"
    },
    "marketId": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "thesisId": {
      "type": "string"
    },
    "confidence": {
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

portfolio_attribution_grouped

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

Parameters10

apiKey	string	required	SimpleFunctions API key
limit	number	optional
from	string	optional	YYYY-MM-DD
to	string	optional	YYYY-MM-DD
groupBy	string	optional	day, venue, marketId, thesisId, thesisStrategyId, portfolioStrategyId, source, viewId, or attributionConfidence
venue	string	optional
marketId	string	optional
source	string	optional
thesisId	string	optional
confidence	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "from": {
      "description": "YYYY-MM-DD",
      "type": "string"
    },
    "to": {
      "description": "YYYY-MM-DD",
      "type": "string"
    },
    "groupBy": {
      "description": "day, venue, marketId, thesisId, thesisStrategyId, portfolioStrategyId, source, viewId, or attributionConfidence",
      "type": "string"
    },
    "venue": {
      "type": "string"
    },
    "marketId": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "thesisId": {
      "type": "string"
    },
    "confidence": {
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

portfolio_risk_get

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

Parameters1

apiKey

string

required

SimpleFunctions API key

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

portfolio_activity_list

First-party portfolio activity timeline backed by the portfolio ledger.

Parameters11

apiKey	string	required	SimpleFunctions API key
limit	number	optional
since	string	optional
until	string	optional
cursor	string	optional
eventType	string	optional
venue	string	optional
marketId	string	optional
source	string	optional
thesisId	string	optional
confidence	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "since": {
      "type": "string"
    },
    "until": {
      "type": "string"
    },
    "cursor": {
      "type": "string"
    },
    "eventType": {
      "type": "string"
    },
    "venue": {
      "type": "string"
    },
    "marketId": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "thesisId": {
      "type": "string"
    },
    "confidence": {
      "type": "string"
    }
  },
  "required": [
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters2

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

tts

Text-to-speech proxy. Returns audio bytes encoded as base64.

Parameters4

apiKey	string	required	SimpleFunctions API key
text	string	required	Text to synthesize
voiceId	string	optional	Voice identifier (provider-specific)
speed	number	optional	Playback speed multiplier

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "text": {
      "description": "Text to synthesize",
      "type": "string"
    },
    "voiceId": {
      "description": "Voice identifier (provider-specific)",
      "type": "string"
    },
    "speed": {
      "description": "Playback speed multiplier",
      "type": "number"
    }
  },
  "required": [
    "apiKey",
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

stt

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

Parameters2

apiKey	string	required	SimpleFunctions API key
audio	string	required	Base64-encoded audio bytes

Raw schema

{
  "type": "object",
  "properties": {
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    },
    "audio": {
      "description": "Base64-encoded audio bytes",
      "type": "string"
    }
  },
  "required": [
    "apiKey",
    "audio"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

explore_theses

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

Parameters1

slug

string

optional

Thesis slug, or empty to list

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Thesis slug, or empty to list",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_heartbeat_config

Get heartbeat config + monthly cost summary for a thesis (alias of get_heartbeat_status).

Parameters2

thesisId	string	required	Thesis ID
apiKey	string	required	SimpleFunctions API key

Raw schema

{
  "type": "object",
  "properties": {
    "thesisId": {
      "description": "Thesis ID",
      "type": "string"
    },
    "apiKey": {
      "description": "SimpleFunctions API key",
      "type": "string"
    }
  },
  "required": [
    "thesisId",
    "apiKey"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_legislation

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

Parameters1

billId

string

required

Bill ID, e.g. "119-hr-22"

Raw schema

{
  "type": "object",
  "properties": {
    "billId": {
      "description": "Bill ID, e.g. \"119-hr-22\"",
      "type": "string"
    }
  },
  "required": [
    "billId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md2 KBView on GitHub

SimpleFunctions CLI (`sf`)

Reference and issue mirror for @spfunctions/cli, the supported SimpleFunctions command-line interface for prediction-market infrastructure.

The current CLI is distributed through npm. Install the package and treat the installed sf binary as the source of truth:

bash

npm i -g @spfunctions/cli
sf login
sf status --json
sf world --json
sf describe --all --json

sf is the primary local surface for SimpleFunctions. It queries live Kalshi + Polymarket state, inspects markets and orderbooks, exports structured JSON for coding agents, runs thesis and portfolio workflows, and keeps execution commands explicit and permission-gated.

What this repository is

Public reference page for the npm package.
Issue tracker for @spfunctions/cli.
Installation, support, and discovery pointer for the current sf surface.

What this repository is not

It is not the current full operator-runtime source tree.
It is not the canonical command inventory.
It should not be used to infer current command counts, market counts, or execution behavior.

Use sf describe --all --json for the installed command manifest. Use https://simplefunctions.dev/api/internal/statistics for current public surface counts.

First useful workflow

bash

sf status --json
sf world --json
sf discover --quality --json
sf inspect <ticker> --json

If a command is unavailable in your installed version, run:

bash

npm i -g @spfunctions/cli@latest
sf describe --all --json

Product surface order

CLI: primary local control plane for humans, shell scripts, cron, Claude Code, Codex, and other coding agents.
HTTP/Data API: network surface for services, dashboards, notebooks, and remote workers.
SDKs and agent runtime: planned wrappers over stable CLI/API object contracts.
MCP: compatibility adapter for MCP-only hosts, not the canonical product center.

License

The public mirror is MIT-licensed. The supported npm distribution may include private SimpleFunctions runtime code.

Install

Tools (108)

get_contextlist_thesesinject_signaltrigger_evaluationscan_marketscreate_thesisexplore_publicget_markets

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "simplefunctions": {
      "command": "npx",
      "args": [
        "-y",
        "@spfunctions/cli@1.7.22"
      ]
    }
  }
}