v0.1.0 · OpenAPI 3.1.0

MCP Connector Hub

Backend MVP to register MCP servers, probe HTTP/OAuth metadata, and generate Hermes Agent mcp_servers config.

OpenAPI JSON Health App
POST/flows/barbearia/auth

Auth

Tags: lp-builder · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "lp-builder"
  ],
  "summary": "Auth",
  "operationId": "auth_flows_barbearia_auth_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/AuthRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/AuthResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
GET/flows/barbearia.json

Get Flow

Tags: lp-builder · Responses: 200

OpenAPI operation
{
  "tags": [
    "lp-builder"
  ],
  "summary": "Get Flow",
  "operationId": "get_flow_flows_barbearia_json_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Get Flow Flows Barbearia Json Get"
          }
        }
      }
    }
  }
}
POST/flows/barbearia/deploy

Deploy

Tags: lp-builder · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "lp-builder"
  ],
  "summary": "Deploy",
  "description": "Deploy LP: receive fields as JSON string + optional logo upload.",
  "operationId": "deploy_flows_barbearia_deploy_post",
  "parameters": [
    {
      "name": "x-token",
      "in": "header",
      "required": false,
      "schema": {
        "type": "string",
        "title": "X-Token"
      }
    }
  ],
  "requestBody": {
    "content": {
      "multipart/form-data": {
        "schema": {
          "$ref": "#/components/schemas/Body_deploy_flows_barbearia_deploy_post"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {}
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
POST/v1/lps/register

Register Lp

Tags: lp tracking · Responses: 201, 422

OpenAPI operation
{
  "tags": [
    "lp tracking"
  ],
  "summary": "Register Lp",
  "operationId": "register_lp_v1_lps_register_post",
  "parameters": [
    {
      "name": "x-token",
      "in": "header",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "X-Token"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/LpRegisterRequest"
        }
      }
    }
  },
  "responses": {
    "201": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true,
            "title": "Response Register Lp V1 Lps Register Post"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
POST/v1/lp-events

Record Lp Event

Tags: lp tracking · Responses: 202, 422

OpenAPI operation
{
  "tags": [
    "lp tracking"
  ],
  "summary": "Record Lp Event",
  "operationId": "record_lp_event_v1_lp_events_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/LpEventRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "202": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response Record Lp Event V1 Lp Events Post"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
GET/v1/lps

List Lps

Tags: lp tracking · Responses: 200

OpenAPI operation
{
  "tags": [
    "lp tracking"
  ],
  "summary": "List Lps",
  "operationId": "list_lps_v1_lps_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": true,
            "type": "object",
            "title": "Response List Lps V1 Lps Get"
          }
        }
      }
    }
  }
}
GET/health

Health

Tags: system · Responses: 200

OpenAPI operation
{
  "tags": [
    "system"
  ],
  "summary": "Health",
  "operationId": "health_health_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Response Health Health Get"
          }
        }
      }
    }
  }
}
GET/v1/catalog

List Catalog

Tags: catalog · Responses: 200

OpenAPI operation
{
  "tags": [
    "catalog"
  ],
  "summary": "List Catalog",
  "operationId": "list_catalog_v1_catalog_get",
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "items": {
              "$ref": "#/components/schemas/CatalogItem"
            },
            "type": "array",
            "title": "Response List Catalog V1 Catalog Get"
          }
        }
      }
    }
  }
}
POST/v1/probe

Probe Url

Tags: probe · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "probe"
  ],
  "summary": "Probe Url",
  "operationId": "probe_url_v1_probe_post",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/ProbeRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ProbeResult"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
POST/v1/mcp-servers

Create Mcp Server

Tags: mcp servers · Responses: 201, 422

OpenAPI operation
{
  "tags": [
    "mcp servers"
  ],
  "summary": "Create Mcp Server",
  "operationId": "create_mcp_server_v1_mcp_servers_post",
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/McpServerCreate"
        }
      }
    }
  },
  "responses": {
    "201": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/McpServer"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
GET/v1/mcp-servers

List Mcp Servers

Tags: mcp servers · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "mcp servers"
  ],
  "summary": "List Mcp Servers",
  "operationId": "list_mcp_servers_v1_mcp_servers_get",
  "parameters": [
    {
      "name": "include_disabled",
      "in": "query",
      "required": false,
      "schema": {
        "type": "boolean",
        "default": true,
        "title": "Include Disabled"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/McpServer"
            },
            "title": "Response List Mcp Servers V1 Mcp Servers Get"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
GET/v1/mcp-servers/{server_id}

Get Mcp Server

Tags: mcp servers · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "mcp servers"
  ],
  "summary": "Get Mcp Server",
  "operationId": "get_mcp_server_v1_mcp_servers__server_id__get",
  "parameters": [
    {
      "name": "server_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Server Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/McpServer"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
PATCH/v1/mcp-servers/{server_id}

Update Mcp Server

Tags: mcp servers · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "mcp servers"
  ],
  "summary": "Update Mcp Server",
  "operationId": "update_mcp_server_v1_mcp_servers__server_id__patch",
  "parameters": [
    {
      "name": "server_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Server Id"
      }
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/McpServerUpdate"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/McpServer"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
DELETE/v1/mcp-servers/{server_id}

Delete Mcp Server

Tags: mcp servers · Responses: 204, 422

OpenAPI operation
{
  "tags": [
    "mcp servers"
  ],
  "summary": "Delete Mcp Server",
  "operationId": "delete_mcp_server_v1_mcp_servers__server_id__delete",
  "parameters": [
    {
      "name": "server_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Server Id"
      }
    }
  ],
  "responses": {
    "204": {
      "description": "Successful Response"
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
POST/v1/mcp-servers/{server_id}/probe

Probe Mcp Server

Tags: probe · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "probe"
  ],
  "summary": "Probe Mcp Server",
  "operationId": "probe_mcp_server_v1_mcp_servers__server_id__probe_post",
  "parameters": [
    {
      "name": "server_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Server Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/ProbeResult"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
POST/v1/mcp-servers/{server_id}/oauth/start

Start Oauth

Tags: oauth · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "oauth"
  ],
  "summary": "Start Oauth",
  "operationId": "start_oauth_v1_mcp_servers__server_id__oauth_start_post",
  "parameters": [
    {
      "name": "server_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Server Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/OAuthStartResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
GET/v1/mcp-servers/{server_id}/oauth/status

Oauth Status

Tags: oauth · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "oauth"
  ],
  "summary": "Oauth Status",
  "operationId": "oauth_status_v1_mcp_servers__server_id__oauth_status_get",
  "parameters": [
    {
      "name": "server_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Server Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/OAuthStatusResponse"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
GET/v1/admin/oauth/meta/diagnostics

Meta Oauth Diagnostics

Tags: oauth · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "oauth"
  ],
  "summary": "Meta Oauth Diagnostics",
  "operationId": "meta_oauth_diagnostics_v1_admin_oauth_meta_diagnostics_get",
  "parameters": [
    {
      "name": "x-admin-token",
      "in": "header",
      "required": false,
      "schema": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "title": "X-Admin-Token"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "boolean"
                }
              ]
            },
            "title": "Response Meta Oauth Diagnostics V1 Admin Oauth Meta Diagnostics Get"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}
POST/v1/mcp-servers/{server_id}/test

Test Mcp Server

Tags: mcp servers · Responses: 200, 422

OpenAPI operation
{
  "tags": [
    "mcp servers"
  ],
  "summary": "Test Mcp Server",
  "operationId": "test_mcp_server_v1_mcp_servers__server_id__test_post",
  "parameters": [
    {
      "name": "server_id",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "title": "Server Id"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/McpTestResult"
          }
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}