Agent integration surface for prediction-market intelligence

Foresea exposes forecasting, market-edge analysis, radar, and track-record data through public agent-readable endpoints. Use MCP for tool-calling agents, OpenAPI for HTTP agents, and server-sent events when an agent wants live conversational output.

Remote MCPConnect agents directly to Foresea tools over streamable HTTP. OpenAPILet HTTP agents discover typed endpoints and schemas. Agent manifestMachine-readable entry points, resources, and recommended workflows.

Recommended Agent Workflow

  1. Read /llms.txt or /.well-known/agent.json for tool discovery.
  2. Use /radar or /agent/scan to find candidate markets.
  3. Use /predict for structured probabilities or /predict/stream for live prose.
  4. Compare against /track-record before trusting the model on a new domain.
  5. Use evidence links returned by the API when presenting a forecast to a user.

MCP

Remote MCP endpoint: https://foresea.ink/mcp/. Discovery manifest: /.well-known/mcp/server.json. 

{
  "mcpServers": {
    "foresea": {
      "url": "https://foresea.ink/mcp/"
    }
  }
}

Primary tools include foresea_forecast, foresea_analyze_market, foresea_scan_markets, foresea_radar, and foresea_track_record.

HTTP Endpoints

Stream a conversational forecast

POST /predict/stream returns server-sent events: meta, delta, done, and error.

curl -N https://foresea.ink/predict/stream \
  -H "Content-Type: application/json" \
  -d '{"question":"Will the Fed cut rates before September 30, 2026?","attach_evidence":false}'

Get a structured probability

POST /predict returns typed JSON with probability, rationale, evidence, and optional market-edge analysis.

curl https://foresea.ink/predict \
  -H "Content-Type: application/json" \
  -d '{"question":"Will oil exceed $100 before the end of 2026?","market_probability":0.31}'

Scan or monitor markets

Discovery Files