Docs/API Reference/MCP Servers API
API5 min read

MCP Servers API

Manage MCP server endpoints for AI assistants

Base URL

text
https://app.conexor.io/api/mcp-servers
https://app.conexor.io/mcp/{orgId}/{endpointName}  # MCP protocol

List MCP Servers

GET /api/mcp-servers
json
[
  {
    "id": "uuid",
    "name": "Sales API",
    "endpointName": "sales-api",
    "endpointUrl": "/mcp/acme/sales-api",
    "toolCount": 5,
    "isEnabled": true,
    "createdAt": "2026-02-23T10:00:00Z"
  }
]

Create MCP Server

POST /api/mcp-servers
json
// Request
{
  "name": "Sales API",
  "description": "Access to sales data",
  "endpointName": "sales-api",
  "toolIds": ["uuid1", "uuid2"],
  "skillIds": ["uuid3"]
}

// Response
{
  "id": "uuid",
  "name": "Sales API",
  "endpointUrl": "/mcp/acme/sales-api",
  "toolCount": 2,
  "apiKeyCount": 0
}

MCP Protocol Endpoint

The JSON-RPC 2.0 endpoint for AI assistants:

POST /mcp/{orgId}/{endpointName}
json
// Request - Initialize
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": { "protocolVersion": "2024-11-05" }
}

// Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2024-11-05",
    "capabilities": { "tools": {}, "resources": {} },
    "serverInfo": { "name": "Sales API", "version": "1.0.0" }
  }
}

MCP Methods

MethodDescription
initializeServer capabilities negotiation
tools/listList available tools
tools/callExecute a tool
resources/listList resources (skills)
resources/readRead a resource
pingHealth check

API Keys

POST /api/mcp-servers/{id}/api-keys

Generate a new API key

DELETE /api/mcp-servers/{id}/api-keys/{keyId}

Revoke an API key

Relay

Quick questions

Relay

Quick questions