MCP SuperHero - API Reference

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

Authorization: Bearer YOUR_API_KEY

You can find your API key in your MCP SuperHero dashboard under Settings > API Keys. Keep your API key secure and never share it publicly.

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.mcpsuperhero.com/v1/connections

Endpoints

GET /v1/connections

Retrieve a list of all active connections for your account.

Query Parameters

limit: number (default: 10)
offset: number (default: 0)
status: string (active, inactive)

Response

{
  "connections": [
    {
      "id": "conn_abc123",
      "name": "My Slack",
      "type": "slack",
      "status": "active",
      "createdAt": "2026-04-09T..."
    }
  ],
  "total": 42
}

POST /v1/connections

Create a new integration connection with a service.

Request Body

{
  "name": "My Integration",
  "type": "slack",
  "credentials": {
    "token": "xoxb-..."
  }
}

Response

{
  "id": "conn_xyz789",
  "name": "My Integration",
  "type": "slack",
  "status": "active",
  "createdAt": "2026-04-09T..."
}

GET /v1/connections/{connectionId}/status

Get the current status and health of a specific connection.

Path Parameters

connectionId: string (required)
Example: "conn_abc123"

Response

{
  "id": "conn_abc123",
  "status": "active",
  "health": "healthy",
  "lastSyncAt": "2026-04-09T14:32:00Z",
  "uptime": 99.98
}

DELETE /v1/connections/{connectionId}

Delete and disconnect an integration. This action cannot be undone.

Path Parameters

connectionId: string (required)
Example: "conn_abc123"

Response

{
  "success": true,
  "message": "Connection deleted",
  "deletedAt": "2026-04-09T15:00:00Z"
}

Error Handling

The API returns standard HTTP status codes to indicate success or failure:

200 OK - Request successful
201 Created - Resource created successfully
400 Bad Request - Invalid request parameters
401 Unauthorized - Missing or invalid API key
403 Forbidden - Insufficient permissions
404 Not Found - Resource not found
429 Too Many Requests - Rate limit exceeded
500 Server Error - Internal server error

Error Response Format

{
  "error": {
    "code": "invalid_request",
    "message": "Missing required field: name",
    "details": {
      "field": "name"
    }
  }
}

Rate Limiting

API requests are rate-limited to 1000 requests per minute per API key. Rate limit information is included in response headers:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1680000000