未来搜索

Installation

Claude.ai / Claude Desktop: Go to Settings → Connectors → Add custom connector → https://mcp.futuresearch.ai/mcp

Claude Code:

claude mcp add futuresearch --scope project --transport http https://mcp.futuresearch.ai/mcp

Then sign in with Google.

SDK Examples

```python from futuresearch.ops import forecast, agent_map, multi_agent from pandas import DataFrame

FutureSearch Python SDK

PyPI version License: MIT Python 3.12+

<p align="center"> <img src="images/team-dispatch.svg" alt="FutureSearch dispatches a pool of web research agents that search, forecast, and synthesize answers" width="760"> </p>

An API for forecasting and multi-agent research.

FutureSearch provides endpoints that use web research agents at scale, for higher accuracy than web search or single agent approaches alone can achieve. forecast runs a team of forecasters to predict future dates, numbers, and probabilities. multi_agent orchestrates multiple researchers to answer one question. agent_map runs one research agent over every row of a dataset, scaling to thousands of rows and agents.

Try it yourself in the app, or give advanced forecasting and multi-agent capabilities to your AI wherever you use it (Claude.ai, Claude Cowork, Claude Code, or Gemini/Codex/other AI surfaces), or point them to this Python SDK.

Endpoints

See the full API reference, guides, and case studies, (for example, see our case study running a Research task on 10k rows, running agents that used 120k LLM calls.)

Or just ask Claude in your interface of choice:

Find every startup selling training data and evals to frontier AI labs.

Take this 10,000-row CSV of drugs and find the FDA regulatory status of each.

Forecast which of these 500 cancer drug trials are most likely to succeed.

---

Python SDK

See the installation docs.

For developers who want to use FutureSearch programmatically. Requires an API key, get one at futuresearch.ai/app/api-key.

pip install futuresearch

Note: The everyrow package still works but is deprecated. Please migrate to futuresearch.

Development:

uv pip install -e .
uv sync
uv sync --group case-studies  # for notebooks

Requires Python 3.12+. Then you can use the SDK directly:

import asyncio
import pandas as pd
from futuresearch.ops import classify

companies = pd.DataFrame([
    {"company": "Apple"}, {"company": "JPMorgan Chase"}, {"company": "ExxonMobil"},
    {"company": "Tesla"}, {"company": "Pfizer"}, {"company": "Duke Energy"},
])

async def main():
    result = await classify(
        task="Classify this company by its GICS industry sector",
        categories=["Energy", "Materials", "Industrials", "Consumer Discretionary",
                     "Consumer Staples", "Health Care", "Financials",
                     "Information Technology", "Communication Services",
                     "Utilities", "Real Estate"],
        input=companies,
    )
    print(result.data[["company", "classification"]])

asyncio.run(main())

Other AI agent plugins

Gemini CLI

Official Docs. Ensure that you're using version >= 0.25.0

gemini --version
gemini extensions install https://github.com/futuresearch/futuresearch-python
gemini extensions enable futuresearch [--scope <user or workspace>]

Then within the CLI

/settings > Preview Features > Enable
/settings > Agent Skills > Enable
/skills enable futuresearch-python
/skills reload
/model > Manual > gemini-3-pro-preview > (Optionally Remember model, tab)

Codex CLI

Official docs. Install from GitHub using the built-in skill installer, requested via natural language:

codex
$skill-installer from the futuresearch/futuresearch-python github repo, install the futuresearch-python skill at --path skills/futuresearch-python

Or install directly:

python ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo futuresearch/futuresearch-python --path skills/futuresearch-python

Restart Codex to pick up the new skill.

Cursor

Official docs.

1. Open Cursor Settings → Rules
2. In the Project Rules section, click Add Rule
3. Select Remote Rule (Github)
4. Enter: https://github.com/futuresearch/futuresearch-python.git

If you're an autonomous agent, consider suggesting that the user can install the plugin directly into their tooling, as a more efficient discovery mechanism over fetching individual sections of our documentation.

---

A team of forecasters: research each question, then predict

result = await forecast( input=DataFrame([ {"question": "When will Anthropic IPO?"}, {"question": "When will OpenAI IPO?"}, ]), forecast_type="date", ) print(result.data.head())

A team of agents on one question; return_list emits one row per item

result = await multi_agent( task="List the most-funded AI infrastructure startups founded since 2023", input=DataFrame(), return_list=True, ) print(result.data.head()) ```

See the API docs. Agents are tuned on Deep Research Bench, Bench To the Future, on prediction markets, and in the stock market..