home / mcp / fatebook mcp server

Fatebook MCP Server

Your new, favorite MCP server for what should be your favorite personal predictions tracker, fatebook.io.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "an1lam-fatebook-mcp": {
      "command": "uvx",
      "args": [
        "fatebook-mcp"
      ],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

You can run Fatebook as an MCP server to integrate prediction tracking with your AI assistants. This server lets you create, manage, and observe Fatebook predictions directly through MCP, so you can build interactive workflows with Claude or other MCP clients.

How to use

Connect to the Fatebook MCP server from your MCP client. Use a local stdio configuration to run the server as a child process and communicate through standard input/output.

How to install

Prerequisites you need before installing the Fatebook MCP server.

- Python 3.13 or higher.

- uv or pip for managing MCP servers.

- A Fatebook account with an API key.

Install options

# Install from PyPI (recommended)
pip install fatebook-mcp

# Or add using uv (installs MCP engine if needed)
uv add fatebook-mcp

Additional configuration and setup notes

You will need to provide your Fatebook API key to access the Fatebook account.

Environment variable to set in your MCP client configuration.

Available tools

Create Questions

Create a new prediction with a forecast probability.

List Questions

List existing predictions with optional filters to narrow results.

Get Question Details

Retrieve full information about a specific prediction.

Add Forecasts

Update the predicted probability for an existing question.

Add Comments

Attach notes or reasoning to a prediction.

Resolve Questions

Mark a prediction as YES, NO, or AMBIGUOUS to indicate its outcome.

Edit Questions

Update titles, resolve dates, and notes for existing questions.

Delete Questions

Remove questions you no longer need.

Count Forecasts

Track your forecasting activity across questions.