Skip to main content

​
MCP Servers Management API

Install, enable, and manage MCP servers that provide tools.

​
Overview

MCP servers expose tools through standardized interfaces. This API lets you:
  • List available MCP servers
  • Toggle server state (enable/disable)
  • Manage custom server definitions
  • Sync configuration across devices

​
GET /mcp_servers

List all MCP servers with user state

​
Authentication

Required

​
Request Example

curl "https://api.agent-corex.com/mcp_servers" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Format

{
  "servers": [
    {
      "name": "github-mcp",
      "display_name": "GitHub",
      "description": "GitHub API and Git operations",
      "url": "https://github.com",
      "enabled": true,
      "installed": true,
      "tools_count": 12,
      "icon": "github",
      "category": "version-control"
    },
    {
      "name": "aws-mcp",
      "display_name": "AWS",
      "description": "Amazon Web Services",
      "url": "https://aws.amazon.com",
      "enabled": false,
      "installed": true,
      "tools_count": 28,
      "icon": "aws",
      "category": "infrastructure"
    }
  ],
  "total": 25,
  "enabled_count": 12
}

​
POST /mcp_servers/toggle

Enable or disable an MCP server

​
Authentication

Required

​
Request Body

FieldTypeRequiredDescription
serverstringYesServer name
enabledbooleanYesEnable/disable

​
Request Example

Enable Server: 
curl -X POST "https://api.agent-corex.com/mcp_servers/toggle" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server": "aws-mcp",
    "enabled": true
  }'
Disable Server: 
curl -X POST "https://api.agent-corex.com/mcp_servers/toggle" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "server": "aws-mcp",
    "enabled": false
  }'

​
Response Format

{
  "server": "aws-mcp",
  "enabled": true,
  "status": "activated",
  "tools_enabled": 28
}

​
Error Cases

Server not found (404): 
{
  "error": {
    "code": "SERVER_NOT_FOUND",
    "message": "Server 'aws-mcp' not found"
  }
}

​
GET /tools/installed

List only user-installed tools

​
Authentication

Required

​
Request Example

curl "https://api.agent-corex.com/tools/installed" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Format

{
  "tools": [
    {
      "name": "create_pull_request",
      "server": "github-mcp",
      "description": "Create a new pull request",
      "enabled": true
    }
  ],
  "total": 40
}

​
GET /mcp_registry

List all available MCP servers from registry

​
Authentication

Not required

​
Request Example

curl "https://api.agent-corex.com/mcp_registry"

​
Response Format

{
  "servers": [
    {
      "name": "github-mcp",
      "display_name": "GitHub",
      "description": "GitHub API and Git operations",
      "version": "1.0.0",
      "tools_count": 12,
      "category": "version-control",
      "tags": ["git", "github", "pr", "issues"],
      "url": "https://github.com",
      "icon": "github"
    }
  ],
  "total": 25
}

​
GET /mcp_registry/

Get specific MCP server from registry

​
Authentication

Not required

​
Path Parameters

ParameterTypeRequired
namestringYes

​
Request Example

curl "https://api.agent-corex.com/mcp_registry/github-mcp"

​
Response Format

{
  "name": "github-mcp",
  "display_name": "GitHub",
  "description": "GitHub API and Git operations",
  "version": "1.0.0",
  "url": "https://github.com",
  "icon": "github",
  "category": "version-control",
  "tags": ["git", "github", "pr", "issues"],
  "tools": [
    {
      "name": "create_pull_request",
      "description": "Create a new pull request"
    },
    {
      "name": "create_issue",
      "description": "Create a new GitHub issue"
    }
  ],
  "tools_count": 12,
  "authentication": {
    "type": "token",
    "required": true,
    "env_var": "GITHUB_TOKEN"
  },
  "rate_limit": {
    "requests_per_hour": 60
  },
  "supported_platforms": ["linux", "macos", "windows"]
}

​
Admin: MCP Registry Management

​
POST /admin/mcp_registry

Create new MCP registry entry Auth: Required (Admin) 
curl -X POST "https://api.agent-corex.com/admin/mcp_registry" \
  -H "Authorization: Bearer ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "custom-mcp",
    "display_name": "Custom Server",
    "description": "My custom MCP server",
    "url": "https://my-server.com",
    "icon": "custom",
    "category": "custom",
    "tools_count": 5
  }'

​
PATCH /admin/mcp_registry/

Update MCP registry entry Auth: Required (Admin) 
curl -X PATCH "https://api.agent-corex.com/admin/mcp_registry/github-mcp" \
  -H "Authorization: Bearer ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated description",
    "tools_count": 15
  }'

​
DELETE /admin/mcp_registry/

Delete MCP registry entry Auth: Required (Admin) 
curl -X DELETE "https://api.agent-corex.com/admin/mcp_registry/github-mcp" \
  -H "Authorization: Bearer ADMIN_KEY"

​
POST /admin/mcp_registry/sync-to-supabase

Sync all registry entries to Supabase Auth: Required (Admin) 
curl -X POST "https://api.agent-corex.com/admin/mcp_registry/sync-to-supabase" \
  -H "Authorization: Bearer ADMIN_KEY"
Response: 
{
  "status": "success",
  "synced_count": 25,
  "timestamp": "2024-01-15T10:30:00Z"
}

​
Server Categories

Available categories:
CategoryExamples
version-controlGitHub, GitLab, Bitbucket
infrastructureAWS, Azure, GCP, Terraform
monitoringDatadog, New Relic, Grafana
messagingSlack, Discord, Telegram
databasesPostgreSQL, MongoDB, Redis
ci-cdGitHub Actions, Jenkins, GitLab CI
developmentVS Code, JetBrains, npm
communicationEmail, SMS, Twilio
customUser-defined servers

​
Server Authentication

​
GitHub Server Example

{
  "server": "github-mcp",
  "authentication": {
    "type": "token",
    "required": true,
    "env_var": "GITHUB_TOKEN",
    "setup_url": "https://github.com/settings/tokens"
  }
}

​
AWS Server Example

{
  "server": "aws-mcp",
  "authentication": {
    "type": "credentials",
    "required": true,
    "env_vars": ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_REGION"],
    "setup_url": "https://aws.amazon.com/iam"
  }
}

​
Best Practices

​
1. Enable Only Needed Servers

// ✅ Good - Enable specific servers
await toggleServer('github-mcp', true);
await toggleServer('aws-mcp', true);

// ❌ Bad - Enable all servers
const servers = await listServers();
servers.forEach(s => toggleServer(s.name, true));

​
2. Check Before Installation

async function installServer(serverName) {
  const server = await getServerFromRegistry(serverName);
  
  // Check if authentication is available
  if (server.authentication.required) {
    const token = process.env[server.authentication.env_var];
    if (!token) {
      throw new Error(`Set ${server.authentication.env_var} environment variable`);
    }
  }
  
  return toggleServer(serverName, true);
}

​
3. Monitor Server Health

async function checkServerHealth() {
  const servers = await listServers();
  
  const health = servers.map(s => ({
    name: s.name,
    enabled: s.enabled,
    tools: s.tools_count,
    status: s.enabled ? 'active' : 'inactive'
  }));
  
  return health;
}

​
Server Synchronization

Sync enabled servers across devices: 
// Device 1: Save state
async function pushServerState() {
  const servers = await listServers();
  const enabled = servers.filter(s => s.enabled).map(s => s.name);
  
  return await pushUserServers({
    enabled_servers: enabled
  });
}

// Device 2: Load state
async function pullServerState() {
  const user = await getUserServers();
  
  for (const server of user.enabled_servers) {
    await toggleServer(server, true);
  }
}

​
Rate Limiting

Server management endpoints:
PlanRequests/min
Free10
Pro100
EnterpriseCustom

​
See Also