agent-swarm.devagent-swarm.dev

MCP Servers

Register and manage MCP tool servers available to swarm agents

GET
/api/agents/{id}/mcp-servers

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Query Parameters

resolveSecrets?string

Response Body

application/json

curl -X GET "http://localhost:3013/api/agents/string/mcp-servers"
{
  "servers": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "scope": "global",
      "ownerAgentId": "string",
      "transport": "stdio",
      "command": "string",
      "args": "string",
      "url": "string",
      "headers": "string",
      "envConfigKeys": "string",
      "headerConfigKeys": "string",
      "extraAuthorizeParams": "string",
      "authMethod": "static",
      "isEnabled": true,
      "version": 0,
      "createdAt": "string",
      "lastUpdatedAt": "string",
      "isActive": true,
      "installedAt": "string",
      "resolvedEnv": {
        "property1": "string",
        "property2": "string"
      },
      "resolvedHeaders": {
        "property1": "string",
        "property2": "string"
      },
      "authError": "string"
    }
  ],
  "total": 0
}
GET
/api/mcp-servers

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

scope?string
transport?string
ownerAgentId?string
enabled?string
search?string

Response Body

application/json

curl -X GET "http://localhost:3013/api/mcp-servers"
{
  "servers": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "scope": "global",
      "ownerAgentId": "string",
      "transport": "stdio",
      "command": "string",
      "args": "string",
      "url": "string",
      "headers": "string",
      "envConfigKeys": "string",
      "headerConfigKeys": "string",
      "extraAuthorizeParams": "string",
      "authMethod": "static",
      "isEnabled": true,
      "version": 0,
      "createdAt": "string",
      "lastUpdatedAt": "string"
    }
  ],
  "total": 0
}
POST
/api/mcp-servers

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "http://localhost:3013/api/mcp-servers" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "transport": "stdio"  }'
{
  "server": {
    "id": "string",
    "name": "string",
    "description": "string",
    "scope": "global",
    "ownerAgentId": "string",
    "transport": "stdio",
    "command": "string",
    "args": "string",
    "url": "string",
    "headers": "string",
    "envConfigKeys": "string",
    "headerConfigKeys": "string",
    "extraAuthorizeParams": "string",
    "authMethod": "static",
    "isEnabled": true,
    "version": 0,
    "createdAt": "string",
    "lastUpdatedAt": "string"
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
DELETE
/api/mcp-servers/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Response Body

application/json

application/json

curl -X DELETE "http://localhost:3013/api/mcp-servers/string"
{
  "success": true,
  "deletedScriptConnectionCount": 0
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
GET
/api/mcp-servers/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Response Body

application/json

application/json

curl -X GET "http://localhost:3013/api/mcp-servers/string"
{
  "id": "string",
  "name": "string",
  "description": "string",
  "scope": "global",
  "ownerAgentId": "string",
  "transport": "stdio",
  "command": "string",
  "args": "string",
  "url": "string",
  "headers": "string",
  "envConfigKeys": "string",
  "headerConfigKeys": "string",
  "extraAuthorizeParams": "string",
  "authMethod": "static",
  "isEnabled": true,
  "version": 0,
  "createdAt": "string",
  "lastUpdatedAt": "string"
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
PUT
/api/mcp-servers/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

[key: string]?unknown

Response Body

application/json

application/json

curl -X PUT "http://localhost:3013/api/mcp-servers/string" \  -H "Content-Type: application/json" \  -d '{    "property1": null,    "property2": null  }'
{
  "server": {
    "id": "string",
    "name": "string",
    "description": "string",
    "scope": "global",
    "ownerAgentId": "string",
    "transport": "stdio",
    "command": "string",
    "args": "string",
    "url": "string",
    "headers": "string",
    "envConfigKeys": "string",
    "headerConfigKeys": "string",
    "extraAuthorizeParams": "string",
    "authMethod": "static",
    "isEnabled": true,
    "version": 0,
    "createdAt": "string",
    "lastUpdatedAt": "string"
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
POST
/api/mcp-servers/{id}/install

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

agentId*string

Response Body

application/json

application/json

curl -X POST "http://localhost:3013/api/mcp-servers/string/install" \  -H "Content-Type: application/json" \  -d '{    "agentId": "string"  }'
{
  "agentMcpServer": {
    "id": "string",
    "agentId": "string",
    "mcpServerId": "string",
    "isActive": true,
    "installedAt": "string"
  }
}
{
  "error": "string",
  "property1": null,
  "property2": null
}
DELETE
/api/mcp-servers/{id}/install/{agentId}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
agentId*string

Response Body

application/json

curl -X DELETE "http://localhost:3013/api/mcp-servers/string/install/string"
{
  "success": true
}

MCP OAuth

OAuth flows for MCP client authorization — register and manage OAuth connections

Memory

Search, retrieve, and manage persistent agent memories across sessions