Edgegap MCP HTTP Service

🚀 Welcome to Edgegap MCP

This service provides a secure HTTPS interface to the Edgegap API, enabling AI agents and applications to deploy game servers globally with ease.

✓ Ready to Use: No server-side configuration required! Simply provide your Edgegap API token with each request.

🔑 Authentication

All API endpoints (except /health) require your Edgegap API token in the Authorization header:

Authorization: Bearer YOUR_EDGEGAP_TOKEN

Or simply:

Authorization: YOUR_EDGEGAP_TOKEN

Get Your API Token

Go to app.edgegap.com
Navigate to Settings → API Tokens
Click Create Token or use an existing one
Copy the token and use it in your requests

📡 API Endpoints

GET /health

Health check endpoint (no authentication required)

GET /api/applications

List all your applications

GET /api/applications/:appName

Get details for a specific application

GET /api/deployments

List all deployments (supports query parameters: app_name, version_name, is_active, etc.)

GET /api/deployments/:requestId

Get deployment status by request ID

POST /api/deploy

Create a new deployment

DELETE /api/deployments/:requestId/stop

Stop a running deployment

DELETE /api/deployments/:requestId

Delete a deployment

GET /api/locations

List all available edge locations

GET /api/context/:ip

Get geographic and network context for an IP address

💻 Usage Examples

Health Check

curl https://mcp.edgegap.com/health

List Applications

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://mcp.edgegap.com/api/applications

Get Active Deployments

curl -H "Authorization: Bearer YOUR_TOKEN" \
  "https://mcp.edgegap.com/api/deployments?is_active=true"

Deploy a Game Server

curl -X POST \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "app_name": "my-game-server",
    "version_name": "v1.0.0",
    "ip_list": ["1.2.3.4"],
    "city": "montreal"
  }' \
  https://mcp.edgegap.com/api/deploy

Check Deployment Status

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://mcp.edgegap.com/api/deployments/REQUEST_ID

List Edge Locations

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://mcp.edgegap.com/api/locations

🤖 Use with Claude Desktop (MCP)

To integrate this service with Claude Desktop using the Model Context Protocol:

Note: This HTTP service is a REST API wrapper. For native MCP integration with Claude Desktop, you'll need to configure the stdio-based MCP server separately.

HTTP API Integration

You can call this HTTP API from any MCP tool or custom integration:

{
  "name": "edgegap-deploy",
  "description": "Deploy game servers via Edgegap",
  "endpoint": "https://mcp.edgegap.com/api/deploy",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer YOUR_TOKEN"
  }
}

🏗️ Architecture

🔒 Secure HTTPS

All traffic is encrypted with Let's Encrypt SSL certificates (auto-renewed)

🔑 Token Pass-Through

Your token is securely forwarded to Edgegap API - nothing stored on our servers

⚡ Fast & Reliable

Lightweight Node.js proxy with nginx for optimal performance

🌍 Global Reach

Access Edgegap's global edge network from any HTTP client or AI agent

📚 Resources

📖 API Documentation 🎮 Dashboard 💬 Discord Community 🏥 Health Check