Connect FutureSearch

Once it is connected, ask for a forecast of anything, including outcomes of your decisions.

Platform

Method

Claude.ai with MCP

Go to Settings → Connectors → Add custom connector.
Enter "FutureSearch" for the name. For the remote MCP URL, use https://mcp.futuresearch.ai/mcp. Then click Add.
Connect and sign in the same way you would when using the FutureSearch web app.
Go to Settings → Capabilities.
Enable Code execution and file creation.
Enable network egress. This allows Claude to use FutureSearch to process files you've uploaded. You can set the domain allowlist to All domains. Or you can specifically allow *.futuresearch.ai.

Try asking about a decision you are facing:

We're deciding whether to install a heat pump next year or run our old gas boiler until it fails. What do we spend on home energy, installation included, over the next ten years? Use what you know about our house.

Or any question about the future:

Which AI lab will have the best model at the end of the year?

Full guide →

Claude Code with MCP

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

Then launch Claude Code and authenticate with Google:

claude
/mcp → select FutureSearch → Authenticate

No API key needed.

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Full guide →

Claude Code with Plugin

The plugin bundles an MCP server and a skill that guides Claude to write Python SDK code for advanced pipelines.

claude plugin marketplace add futuresearch/futuresearch-python
claude plugin install futuresearch@futuresearch

Then launch Claude Code and authenticate:

claude
/mcp → select FutureSearch → Authenticate

No API key needed.

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Full guide →

Python SDK with pip

pip install futuresearch

Requires an API key:

export FUTURESEARCH_API_KEY=sk-cho-...

Getting Started → | API Reference →

Dependencies: Python 3.12+ and pip.

Python SDK with uv

uv add futuresearch

Requires an API key:

export FUTURESEARCH_API_KEY=sk-cho-...

Getting Started → | API Reference →

Dependencies: Python 3.12+ and uv.

Codex with Skills

Ask Codex in natural language:

>>> codex
>>> Install the skill from github.com/futuresearch/futuresearch-python found under skills/futuresearch-python

Or install manually:

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.

Important: be sure to supply your API key when launching Codex:

export FUTURESEARCH_API_KEY=sk-cho...
codex

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Official Docs

Codex with MCP

Add FutureSearch to your Codex MCP config (requires uv):

[mcp_servers.futuresearch]
command = "uvx"
args = ["futuresearch-mcp"]

[mcp_servers.futuresearch.env]
FUTURESEARCH_API_KEY = "${FUTURESEARCH_API_KEY}"

Or use the CLI:

codex mcp add futuresearch --env FUTURESEARCH_API_KEY=${FUTURESEARCH_API_KEY} -- uvx futuresearch-mcp

Config file location:

User scope: ~/.codex/config.toml
Project scope: .codex/config.toml

Important: either insert your API key when creating the config file, or supply the key when launching Codex:

export FUTURESEARCH_API_KEY=sk-cho...
codex

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Official Docs

Gemini with Skills

Install the skill directly from GitHub:

gemini skills install https://github.com/futuresearch/futuresearch-python --path skills/futuresearch-python

Use --scope workspace to install to .gemini/skills/ (project-level) instead of ~/.gemini/skills/ (user-level).

Then enable skills within the CLI:

/settings > Preview Features > Enable
/settings > Agent Skills > Enable
/skills enable futuresearch-python
/skills reload

Try asking about a decision you are facing:

We're deciding whether to install a heat pump next year or run our old gas boiler until it fails. What do we spend on home energy, installation included, over the next ten years? Use what you know about our house.

Or any question about the future:

Which AI lab will have the best model at the end of the year?

Official Docs

Gemini with MCP

Add via CLI (requires uv):

gemini mcp add -e FUTURESEARCH_API_KEY=$FUTURESEARCH_API_KEY futuresearch uvx futuresearch-mcp

Or add manually to ~/.gemini/settings.json (user) or .gemini/settings.json (project):

{
  "mcpServers": {
    "futuresearch": {
      "command": "uvx",
      "args": ["futuresearch-mcp"],
      "env": {
        "FUTURESEARCH_API_KEY": "$FUTURESEARCH_API_KEY"
      }
    }
  }
}

Try asking about a decision you are facing:

We're deciding whether to install a heat pump next year or run our old gas boiler until it fails. What do we spend on home energy, installation included, over the next ten years? Use what you know about our house.

Or any question about the future:

Which AI lab will have the best model at the end of the year?

Official Docs

Gemini with Plugin

This installs both the MCP server and skills together.

gemini extensions install https://github.com/futuresearch/futuresearch-python --ref main

When prompted with Would you like to attempt to install via "git clone" instead?, type Y to confirm.

Then enable the extension:

gemini extensions enable futuresearch [--scope <user or workspace>]

To use skills, enable them within the CLI:

/settings > Preview Features > Enable
/settings > Agent Skills > Enable
/skills enable futuresearch-python
/skills reload
/model > Manual > gemini-3-pro-preview

Try asking about a decision you are facing:

We're deciding whether to install a heat pump next year or run our old gas boiler until it fails. What do we spend on home energy, installation included, over the next ten years? Use what you know about our house.

Or any question about the future:

Which AI lab will have the best model at the end of the year?

Official Docs

Cursor with Skills

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

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Official Docs

Cursor with MCP

Or add manually to your MCP config (requires uv):

{
  "mcpServers": {
    "futuresearch": {
      "command": "uvx",
      "args": ["futuresearch-mcp"],
      "env": {
        "FUTURESEARCH_API_KEY": "${env:FUTURESEARCH_API_KEY}"
      }
    }
  }
}

Config file location:

macOS: ~/.cursor/mcp.json
Windows: %USERPROFILE%\.cursor\mcp.json

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Connect FutureSearch

Once it is connected, ask for a forecast of anything, including outcomes of your decisions.

Platform

Method

Claude.ai with MCP

Go to Settings → Connectors → Add custom connector.
Enter "FutureSearch" for the name. For the remote MCP URL, use https://mcp.futuresearch.ai/mcp. Then click Add.
Connect and sign in the same way you would when using the FutureSearch web app.
Go to Settings → Capabilities.
Enable Code execution and file creation.
Enable network egress. This allows Claude to use FutureSearch to process files you've uploaded. You can set the domain allowlist to All domains. Or you can specifically allow *.futuresearch.ai.

Try asking about a decision you are facing:

We're deciding whether to install a heat pump next year or run our old gas boiler until it fails. What do we spend on home energy, installation included, over the next ten years? Use what you know about our house.

Or any question about the future:

Which AI lab will have the best model at the end of the year?

Full guide →

Claude Code with MCP

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

Then launch Claude Code and authenticate with Google:

claude
/mcp → select FutureSearch → Authenticate

No API key needed.

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Full guide →

Claude Code with Plugin

The plugin bundles an MCP server and a skill that guides Claude to write Python SDK code for advanced pipelines.

claude plugin marketplace add futuresearch/futuresearch-python
claude plugin install futuresearch@futuresearch

Then launch Claude Code and authenticate:

claude
/mcp → select FutureSearch → Authenticate

No API key needed.

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Full guide →

Python SDK with pip

pip install futuresearch

Requires an API key:

export FUTURESEARCH_API_KEY=sk-cho-...

Getting Started → | API Reference →

Dependencies: Python 3.12+ and pip.

Python SDK with uv

uv add futuresearch

Requires an API key:

export FUTURESEARCH_API_KEY=sk-cho-...

Getting Started → | API Reference →

Dependencies: Python 3.12+ and uv.

Codex with Skills

Ask Codex in natural language:

>>> codex
>>> Install the skill from github.com/futuresearch/futuresearch-python found under skills/futuresearch-python

Or install manually:

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.

Important: be sure to supply your API key when launching Codex:

export FUTURESEARCH_API_KEY=sk-cho...
codex

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Official Docs

Codex with MCP

Add FutureSearch to your Codex MCP config (requires uv):

[mcp_servers.futuresearch]
command = "uvx"
args = ["futuresearch-mcp"]

[mcp_servers.futuresearch.env]
FUTURESEARCH_API_KEY = "${FUTURESEARCH_API_KEY}"

Or use the CLI:

codex mcp add futuresearch --env FUTURESEARCH_API_KEY=${FUTURESEARCH_API_KEY} -- uvx futuresearch-mcp

Config file location:

User scope: ~/.codex/config.toml
Project scope: .codex/config.toml

Important: either insert your API key when creating the config file, or supply the key when launching Codex:

export FUTURESEARCH_API_KEY=sk-cho...
codex

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Official Docs

Gemini with Skills

Install the skill directly from GitHub:

gemini skills install https://github.com/futuresearch/futuresearch-python --path skills/futuresearch-python

Use --scope workspace to install to .gemini/skills/ (project-level) instead of ~/.gemini/skills/ (user-level).

Then enable skills within the CLI:

/settings > Preview Features > Enable
/settings > Agent Skills > Enable
/skills enable futuresearch-python
/skills reload

Try asking about a decision you are facing:

We're deciding whether to install a heat pump next year or run our old gas boiler until it fails. What do we spend on home energy, installation included, over the next ten years? Use what you know about our house.

Or any question about the future:

Which AI lab will have the best model at the end of the year?

Official Docs

Gemini with MCP

Add via CLI (requires uv):

gemini mcp add -e FUTURESEARCH_API_KEY=$FUTURESEARCH_API_KEY futuresearch uvx futuresearch-mcp

Or add manually to ~/.gemini/settings.json (user) or .gemini/settings.json (project):

{
  "mcpServers": {
    "futuresearch": {
      "command": "uvx",
      "args": ["futuresearch-mcp"],
      "env": {
        "FUTURESEARCH_API_KEY": "$FUTURESEARCH_API_KEY"
      }
    }
  }
}

Try asking about a decision you are facing:

We're deciding whether to install a heat pump next year or run our old gas boiler until it fails. What do we spend on home energy, installation included, over the next ten years? Use what you know about our house.

Or any question about the future:

Which AI lab will have the best model at the end of the year?

Official Docs

Gemini with Plugin

This installs both the MCP server and skills together.

gemini extensions install https://github.com/futuresearch/futuresearch-python --ref main

When prompted with Would you like to attempt to install via "git clone" instead?, type Y to confirm.

Then enable the extension:

gemini extensions enable futuresearch [--scope <user or workspace>]

To use skills, enable them within the CLI:

/settings > Preview Features > Enable
/settings > Agent Skills > Enable
/skills enable futuresearch-python
/skills reload
/model > Manual > gemini-3-pro-preview

Try asking about a decision you are facing:

We're deciding whether to install a heat pump next year or run our old gas boiler until it fails. What do we spend on home energy, installation included, over the next ten years? Use what you know about our house.

Or any question about the future:

Which AI lab will have the best model at the end of the year?

Official Docs

Cursor with Skills

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

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?

Official Docs

Cursor with MCP

Or add manually to your MCP config (requires uv):

{
  "mcpServers": {
    "futuresearch": {
      "command": "uvx",
      "args": ["futuresearch-mcp"],
      "env": {
        "FUTURESEARCH_API_KEY": "${env:FUTURESEARCH_API_KEY}"
      }
    }
  }
}

Config file location:

macOS: ~/.cursor/mcp.json
Windows: %USERPROFILE%\.cursor\mcp.json

Try asking about a decision you are facing:

We're deciding whether to raise our $20 plan to $29 for new customers only, raise it for everyone, or leave it alone. How many paying subscribers will we have a year from now? Use what you know about our business from this repo.

Or any question about the future:

How many tech layoffs will there be by the end of 2026?