Skip to main content
Glama

Fatebook MCP Server

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

Testing and Compatibility

This MCP server has been tested on Mac OS X 14.5 with:

  • Claude Code (CLI)
  • Claude Desktop
  • MCP Inspector

As far as I know, it doesn't violate any MCP protocol requirements but given that MCP is an evolving protocol, certain features or MCP clients may not be fully supported. If you encounter issues with other MCP implementations, please report them as GitHub issues.

Installation

Prerequisites

  • Python 3.13 or higher
  • uv (recommended) or pip
  • A Fatebook account and API key

Getting your Fatebook API Key

  1. Sign in to Fatebook
  2. Navigate to API Setup
  3. Generate and copy your API key

Install the package directly from PyPI:

pip install fatebook-mcp

Or using uv:

uv add fatebook-mcp

Option 2: Install from Source

For development or the latest features:

  1. Clone the repository:
git clone https://github.com/an1lam/fatebook-mcp.git cd fatebook-mcp
  1. Install dependencies using uv:
uv sync

Quick Start

Running Directly with uvx

The easiest way to test the server after installation is with uvx:

# Run directly from PyPI (no installation needed) uvx fatebook-mcp # Or run from local directory during development uvx --from . fatebook-mcp

The server will start and wait for MCP client connections via stdio. Use Ctrl+C to stop it.

Usage with Claude Desktop and Claude Code

Claude Desktop

Add one of the following configurations to your Claude Desktop configuration file:

macOS

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

Windows

Location: %APPDATA%\Claude\claude_desktop_config.json

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

Note: If Claude Desktop can't find uvx, use the full path instead:

{ "mcpServers": { "fatebook": { "command": "/Users/yourusername/.local/bin/uvx", "args": ["fatebook-mcp"], "env": { "FATEBOOK_API_KEY": "your-api-key-here" } } } }

Find your uvx path with: which uvx

Option 2: Development/Source Installation
{ "mcpServers": { "fatebook": { "command": "uv", "args": [ "--directory", "/path/to/fatebook-mcp", "run", "python", "-m", "fatebook_mcp" ], "env": { "FATEBOOK_API_KEY": "your-api-key-here" } } } }

Replace /path/to/fatebook-mcp with the actual path to where you cloned this repository.

Claude Code (CLI)

For Claude Code, you can add this server in several ways:

# Add the Fatebook MCP server using uvx claude mcp add fatebook --env FATEBOOK_API_KEY=your-api-key-here -- uvx fatebook-mcp # Verify it was added successfully claude mcp list
Option 2: Import from Claude Desktop

If you already have this configured in Claude Desktop, you can import those settings:

claude mcp add-from-claude-desktop
Option 3: Project-specific configuration

Create a .mcp.json file in your project:

Using PyPI package:

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

If uvx is not found, use the full path (find with which uvx):

{ "mcpServers": { "fatebook": { "command": "/Users/yourusername/.local/bin/uvx", "args": ["fatebook-mcp"], "env": { "FATEBOOK_API_KEY": "your-api-key-here" } } } }

Using development/source installation:

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

Replace /path/to/fatebook-mcp with the actual path to where you cloned this repository.

Development & Testing

Additional setup

Beyond the above setup that's needed even just to use the MCP server, running the MCP server as standalone and running its tests require fetching your API key and exporting it in your environment.

You can do this either by exporting it directly:

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

Or create a .env file:

FATEBOOK_API_KEY=your-api-key-here

Running integration tests

Run the integration tests to verify your setup:

uv run pytest test_client.py

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

Note: These tests will only succeed if you have the right API key for the test user. If you're developing such that you need to run these tests, for now email me (the author).

Running the Server Locally

Using uvx (recommended):

uvx --from . fatebook-mcp

Using uv run with module:

uv run python -m fatebook_mcp

The server will start and wait for MCP client connections.

Testing and Compatibility

This MCP server has been tested with:

  • Claude Code (CLI)
  • Claude Desktop
  • MCP Inspector

As MCP is an evolving protocol, certain features or MCP clients may not be fully supported. If you encounter issues with other MCP implementations, please report them as GitHub issues.

Troubleshooting

uvx Command Not Found

If Claude Desktop shows "command not found" errors for uvx:

  1. Find your uvx path:
    which uvx
  2. Use the full path in your configuration:
    "command": "/Users/yourusername/.local/bin/uvx"
  3. Common uvx locations:
    • macOS: /Users/yourusername/.local/bin/uvx
    • Linux: /home/yourusername/.local/bin/uvx

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

Examples

Claude Desktop

Creating and tracking a prediction: example interaction

Reviewing your predictions: example review interaction

Claude Code

example list interaction

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
Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. Features
    1. Testing and Compatibility
      1. Installation
        1. Prerequisites
        2. Getting your Fatebook API Key
        3. Option 1: Install from PyPI (Recommended)
        4. Option 2: Install from Source
      2. Quick Start
        1. Running Directly with uvx
      3. Usage with Claude Desktop and Claude Code
        1. Claude Desktop
        2. Claude Code (CLI)
      4. Development & Testing
        1. Additional setup
        2. Running integration tests
        3. Running the Server Locally
      5. Testing and Compatibility
        1. Troubleshooting
          1. uvx Command Not Found
          2. API Key Issues
          3. Connection Issues
          4. Question Format
        2. Examples
          1. Claude Desktop
          2. Claude Code
        3. API Documentation
          1. Contributing
            1. Support

              Related MCP Servers

              • -
                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 -
                • Apple
              • A
                security
                A
                license
                A
                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 -
                253
                36
                TypeScript
                Apache 2.0
                • Linux
                • Apple
              • 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
                • Apple
                • Linux
              • A
                security
                A
                license
                A
                quality
                Server that enables AI assistants to interact with Storybook design systems. Extract component HTML, analyze styles, and help with design system adoption and refactoring.
                Last updated -
                8
                63
                19
                MIT License

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/an1lam/fatebook-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server