MCP Reference

Model Context Protocol integration for AI assistants

What is MCP?

Model Context Protocol enables seamless integration with AI assistants

MCP Overview

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. Fatum implements MCP to provide astrological insights directly within your favorite AI assistant platforms.

MCP Server

Fatum provides an MCP server that exposes astrological tools and data to compatible AI assistants.

Available Tools

Access horoscopes, birth charts, compatibility analysis, and more through standardized MCP tools.

Easy Setup

Simple configuration process to connect Fatum with your AI assistant in minutes.

Open Standard

Built on the open MCP standard, ensuring compatibility and interoperability.

Available MCP Tools

TOOLget_horoscope

Retrieve daily, weekly, or monthly horoscope for any zodiac sign

TOOLgenerate_birth_chart

Create a detailed birth chart analysis based on birth date, time, and location

TOOLcheck_compatibility

Calculate compatibility between two zodiac signs or birth charts

TOOLget_transits

Get current planetary transits and their astrological influences

TOOLask_astrologer

Ask questions to Fatum's AI astrology assistant and receive personalized insights

Installation & Setup

Follow these steps to integrate Fatum MCP with your AI assistant:

Step 1: Install MCP Server

npm install -g @fatum/mcp-server

Step 2: Configure Your API Key

export FATUM_API_KEY="your_api_key_here"

Step 3: Add to MCP Config

Add Fatum to your MCP configuration file:

{
  "mcpServers": {
    "fatum": {
      "command": "fatum-mcp-server",
      "args": [],
      "env": {
        "FATUM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Step 4: Restart Your AI Assistant

Restart your AI assistant to load the Fatum MCP server. You should now see Fatum tools available in your assistant.

Example Usage

Once configured, you can use Fatum tools directly in your AI assistant:

User:

"What's my horoscope for today? I'm a Leo."

Assistant:

[Uses get_horoscope tool with zodiac_sign="leo" and period="daily"]

"Today is a day of creative expression for Leo! The Sun's energy empowers you to shine in social situations..."

Supported Platforms

Claude Desktop

Full support

Cursor

Full support

Other MCP Clients

Compatible

Coming Soon

MCP integration will be available with the beta release. Sign up for our waiting list to be notified when MCP access becomes available and receive your API key.