Back to API Documentation

Config API

MCP hub coordination and service discovery

Version
1.0.0
Base URL
ws://hyperion:9999/config-api
Endpoints
8

Endpoints

GET/api/v1/mcp/catalog

Get complete MCP tools catalog with all available tools

Response

{
  "tools": [
    {
      "name": "tasks-mcp_agent_task_create",
      "description": "Create a new task assigned to an agent",
      "service": "tasks-api",
      "localName": "agent_task_create",
      "parameters": {
        "processId": { "type": "string", "required": true },
        "name": { "type": "string", "required": true },
        "assignedTo": { "type": "object", "required": true }
      }
    }
  ],
  "totalTools": 157,
  "services": 6
}
GET/api/v1/mcp/servers

List all registered MCP servers and their status

Response

{
  "servers": [
    {
      "name": "tasks-api",
      "url": "http://tasks-api:8083",
      "status": "healthy",
      "toolCount": 35,
      "lastHealthCheck": "2025-01-08T18:30:00Z"
    },
    {
      "name": "documents-api", 
      "url": "http://documents-api:8084",
      "status": "healthy",
      "toolCount": 28,
      "lastHealthCheck": "2025-01-08T18:30:00Z"
    }
  ],
  "totalServers": 6
}
POST/api/v1/mcp/refresh

Refresh tool catalog from all services

Response

{
  "refreshed": true,
  "totalTools": 157,
  "updatedServices": [
    "tasks-api",
    "documents-api", 
    "staff-api",
    "chat-api"
  ],
  "refreshedAt": "2025-01-08T19:00:00Z"
}