Fatebook MCP Server

A Model Context Protocol (MCP) server that provides integration with Fatebook, a prediction tracking platform. This server allows AI assistants like Claude to create, manage, and track predictions directly through MCP.

Features

Create Questions: Make predictions with forecasts (0-100% probability)
List Questions: View your predictions with filtering options
Get Question Details: Retrieve comprehensive information about specific questions
Add Forecasts: Update your predicted probabilities on existing questions
Add Comments: Add commentary to track your reasoning
Resolve Questions: Mark questions as resolved (YES/NO/AMBIGUOUS)
Edit Questions: Update question titles, resolve dates, and notes
Delete Questions: Remove questions you no longer need
Count Forecasts: Track your forecasting activity

Installation

Prerequisites

Python 3.13 or higher
uv (Python package manager)
A Fatebook account and API key

Getting your Fatebook API Key

Sign in to Fatebook
Navigate to API Setup
Generate and copy your API key

Setup

Clone the repository:

git clone https://github.com/yourusername/fatebook-mcp.git
cd fatebook-mcp

Install dependencies using uv:

uv sync

Set up your API key (optional - you can also provide it per request):

export FATEBOOK_API_KEY="your-api-key-here"

Or create a .env file:

FATEBOOK_API_KEY=your-api-key-here

Usage with Claude Desktop

Add the following to your Claude Desktop configuration file:

macOS

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Location: %APPDATA%\Claude\claude_desktop_config.json

Configuration

{
  "mcpServers": {
    "fatebook": {
      "command": "path/to/uv",
      "args": [
        "run",
        "python",
        "/path/to/fatebook-mcp/main.py"
      ],
      "env": {
        "FATEBOOK_API_KEY": "your-api-key-here"
      }
    }
  }
}

Replace /path/to/fatebook-mcp with the actual path to where you cloned this repository and path/to/uv with the output of which uv.

Development & Testing

Running integration tests

Run the integration tests to verify your setup:

uv run test_client.py

This will test all available endpoints and confirm the server is working correctly.

Running the Server Locally

uv run python main.py

The server will start and wait for MCP client connections.

Troubleshooting

API Key Issues

Ensure your API key is valid and active
Check that the API key is properly set in environment or config
Try providing the API key directly in the request

Connection Issues

Verify the server path in your Claude Desktop config is correct
Check that Python 3.13+ is installed and accessible
Ensure uv dependencies are properly installed with uv sync

Question Format

Dates should be in YYYY-MM-DD format
Forecast values must be between 0.0 and 1.0
Question IDs are provided when creating questions

Example Conversations with Claude

Creating and tracking a prediction:

User: Create a Fatebook question about whether it will rain tomorrow in SF, resolving tomorrow, 70% chance

Claude: I'll create that Fatebook question for you.

**Question Created Successfully!**
Title: Will it rain tomorrow in SF?
ID: cme6h2si00001bwlzf9qg7tt0
URL: https://fatebook.io/q/will-it-rain-tomorrow-in-sf--cme6h2si00001bwlzf9qg7tt0

User: Actually, checking the weather forecast, update my prediction to 40%

Claude: I'll update your forecast to 40% for that question.

Forecast added successfully!

Reviewing your predictions:

User: Show me my unresolved Fatebook questions about AI

Claude: Here are your unresolved questions about AI:

**Will GPT-5 be released by end of 2025?**
? OPEN | ID: cme6h2si00001bwlzf9qg7tt0 | 3 forecasts | Tags: ai, openai

**Will any AI system score >90% on ARC-AGI by 2025?**
? OPEN | ID: cme1m5hde0007142kojke80mp | 5 forecasts | Tags: ai, benchmarks

API Documentation

For more details about the Fatebook API, see:

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Support

For issues with:

This MCP server: Open an issue on GitHub
Fatebook API: Contact Fatebook support
MCP/Claude Desktop: See MCP documentation

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI assistants to create, manage, and track predictions on Fatebook, a prediction tracking platform. Supports making forecasts, updating probabilities, resolving questions, and managing prediction history through natural language.

Related MCP Servers

Metabase Server MCP
berry-street
-
security
F
license
-
quality
Enables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.
Last updated -
JavaScript
Metabase MCP
hyeongjun-dev
-
security
F
license
-
quality
Connect AI assistants to your Metabase analytics platform. Access dashboards, execute queries, and retrieve data seamlessly through conversational interfaces. Enhance your analytics experience with structured data access and robust error handling.
Last updated -
19
JavaScript
Financial Modeling Prep MCP Server
imbenrabi
-
security
A
license
-
quality
Enables AI assistants to access and analyze financial data including stock information, company fundamentals, and market insights through the Financial Modeling Prep API.
Last updated -
24
TypeScript
Apache 2.0
MCP Paradex Server
Habinar
A
security
A
license
A
quality
A bridge between AI assistants and the Paradex perpetual futures trading platform that enables retrieving market data, managing trading accounts, placing orders, and monitoring positions.
Last updated -
26
1
MIT License

View all related MCP servers

Fatebook MCP Server