MCPServer_aiprediction_us

AI Prediction MCP Server

A Model Context Protocol (MCP) server that provides Claude with access to AI prediction data from the aiprediction.us API.

AI Prediction MCP Server

A Model Context Protocol (MCP) server that provides Claude with access to AI prediction data from the aiprediction.us API. This server handles authentication, date formatting, and data retrieval to give Claude seamless access to trading predictions and analysis.

🚀 Features

• Automatic Authentication: Handles token-based authentication with the AI Prediction API

• Date Management: Converts dates to YYMMDD format and gets current date automatically

• Real-time Data: Retrieves last elements data for any date

• Error Handling: Comprehensive logging and error recovery

• Token Management: Automatic token refresh when expired

📋 Prerequisites

• Python 3.8 or higher

• Active account on aiprediction.us

• Claude Desktop (or another MCP-compatible client)

🛠️ Installation

1. Clone or Download Files

Download these files to your project directory:

• MCPServer.py (the main MCP server)

• requirements.txt (Python dependencies)

• .env.example (environment configuration template)

2. Set Up Python Environment

Option A: Using venv (Recommended)

Option B: Using conda

Option C: Global Installation

3. Configure Environment Variables

1. Copy the example file:

   cp .env.example .env

2. Edit

   # AI Prediction API Configuration API_BASE_URL=https://aiprediction.us API_USERNAME=your_username_here API_PASSWORD=your_password_here

   Replace your_username_here and your_password_here with your actual aiprediction.us credentials.

🎯 Running the MCP Server

Test the Server

You should see output like:

If you see errors:

• Missing credentials: Check your .env file

• Authentication failed: Verify your username/password

• API errors: Check your network connection

Keep Server Running

The MCP server needs to stay running while you use Claude. You can:

• Run it in a terminal and keep it open

• Use screen/tmux for persistent sessions

• Run as a background service

🔧 Configure Claude Desktop

1. Find Claude's Configuration File

macOS:

Windows:

2. Add MCP Server Configuration

Edit the configuration file and add your MCP server:

Important: Replace /full/path/to/your/aiprediction-mcp-server.py with the actual full path to your script.

3. Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.

💬 Using Claude with AI Prediction Data

Once configured, you can ask Claude to access your AI prediction data:

Example Queries

Get Today's Data:

Get Specific Date:

Date Conversion:

Historical Analysis:

Available Tools

Claude will have access to these tools:

1. get_current_date_data - Gets prediction data for today

2. get_last_elements_by_date - Gets data for any specific date

3. format_date_yymmdd - Converts dates to YYMMDD format

4. get_api_debug_info - Gets API status and debug information

Data Structure

The API returns data with this structure:

🔍 Troubleshooting

Common Issues

1. "Missing credentials" Error

• Check your .env file exists and has correct format

• Ensure no extra spaces around the = signs

• Verify file is in same directory as the script

2. "Authentication failed" Error

• Verify your username and password are correct

• Check if your aiprediction.us account is active

• Try logging in via the website first

3. "MCP Server not found" in Claude

• Check the full path in claude_desktop_config.json

• Ensure Python is in your system PATH

• Try using absolute path to Python executable

4. "No data found" for specific dates

• Some dates may not have prediction data

• Try recent trading days (weekdays)

• Check if the date format is correct (YYMMDD)

Debug Mode

To see detailed logging, you can modify the server to show more information:

Check Configuration

Verify Claude can see your MCP server:

1. Open Claude Desktop

2. Look for MCP server indicators in the interface

3. Try asking: "What MCP tools do you have access to?"

📚 API Reference

Environment Variables

Date Format

The API uses YYMMDD format:

• 250613 = June 13, 2025

• 241225 = December 25, 2024

• 240101 = January 1, 2024

Available Endpoints

The MCP server accesses these API endpoints:

• POST /api-token-auth/ - Authentication

• GET /api/v53a/{did}/last-elements/ - Get prediction data

• GET /api/debug/v53a/general/ - Debug information

🤝 Contributing

To improve this MCP server:

1. Fork the repository

2. Make your changes

3. Test with your AI Prediction account

4. Submit a pull request

📄 License

This project is licensed under the MIT License.

🆘 Support

For issues:

1. Check the troubleshooting section above

2. Verify your aiprediction.us account works via their website

3. Test the MCP server output for detailed error messages

4. Check Claude Desktop's MCP configuration

Happy Trading with AI Predictions! 📈# aiprediction_us_MCP_Server