poll-the-people/customgpt-mcp

A **full-featured** Model Context Protocol (MCP) server that provides seamless access to CustomGPT.ai APIs. Interact with your CustomGPT agents directly through Claude Code, Claude Web, and any MCP-compatible client.
Features
Agent Management
- **List Agents**: Browse all your CustomGPT agents with pagination
- **Get Agent Details**: Retrieve detailed information about specific agents
- **Create Agents**: Create new agents from sitemaps or files
- **Agent Statistics**: Get usage stats, page counts, and conversation metrics
- **Agent Settings**: View and configure agent behavior and appearance
Conversation Management
- **Send Messages**: Chat with your agents using OpenAI-compatible format
- **List Conversations**: Browse conversation history for any agent
- **Message History**: Retrieve full conversation transcripts
Content Management
- **List Pages**: View all pages/sources for your agents
- **Page Status**: Check crawl and indexing status
- **Content Sources**: Manage sitemaps and uploaded files
API Documentation Integration
- **Search Documentation**: Find relevant API endpoints and documentation
- **Endpoint Details**: Get comprehensive information about specific API endpoints
- **Interactive Help**: Built-in API reference with examples
Security & Privacy
- **API Key Masking**: Secure API key handling with automatic masking in logs
- **Validation**: Built-in API key validation and format checking
- **No Storage**: Stateless design - API keys are never stored permanently
Quick Start
Prerequisites
- **Python 3.10+** (required for FastMCP)
- A valid CustomGPT.ai API key from CustomGPT Dashboard
- MCP-compatible client (Claude Code, Claude Web, etc.)
Installation
**Recommended Setup**
Option 2: Using Docker
Option 3: Deploy to Railway (Recommended for Production)
1. Click the Railway button above
2. Set your environment variables
3. Deploy with one click
Local Development
🔧 Configuration
Environment Variables
Create a .env file in the project root:
MCP Client Configuration
Claude Code
Add to your MCP settings:
Claude Web
1. Go to Claude Web Settings
2. Add MCP Server: https://your-deployed-server.railway.app
3. Configure with your CustomGPT API key
🛠️ Available Tools
Agent Management
list_agents
List all your CustomGPT agents with pagination support.
get_agent
Get detailed information about a specific agent.
create_agent
Create a new agent from a sitemap or files.
Conversation Tools
send_message
Send a message to any of your agents.
list_conversations
List all conversations for a specific agent.
Content Management
list_pages
List all pages/sources for an agent.
get_agent_stats
Get statistics for an agent.
get_agent_settings
Get configuration settings for an agent.
Documentation Tools
search_api_documentation
Search the CustomGPT API documentation.
get_api_endpoint_details
Get detailed information about a specific API endpoint.
Utility Tools
validate_api_key
Validate your CustomGPT API key.
📊 Usage Examples
Basic Agent Interaction
Creating and Managing Agents
🚀 Deployment Options
Railway (Recommended)
Railway provides the best hosting experience for MCP servers with automatic HTTPS, custom domains, and easy scaling.
1. Fork this repository
2. Connect to Railway
3. Set environment variables