Skip to main content
POST
/
api
/
mcp-servers
Create MCP server
curl --request POST \
  --url http://localhost:8080/api/mcp-servers \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-API-SECRET: <api-key>' \
  --data '
{
  "config": {
    "name": "Everything MCP Server",
    "url": "https://raw.githubusercontent.com/modelcontextprotocol/server-everything/main/package.json",
    "description": "Reference implementation MCP server with all features",
    "approval_policy": "require_approval_all",
    "transport": "SSE",
    "request_headers": {
      "User-Agent": "MCP-Client/1.0",
      "Accept": "application/json"
    },
    "secret_token": {
      "secret_id": "secret_token_123"
    }
  }
}
'
{
  "message": "MCP server created successfully",
  "status": "success",
  "error": null,
  "data": {
    "id": "mcp_8c180796-e6d7-4343-88b5-5df0846fef69",
    "organization_id": "org_2zC2v0GqxbrfKq1rKazb3gFcPEq",
    "url": "https://raw.githubusercontent.com/modelcontextprotocol/server-everything/main/package.json",
    "name": "Everything MCP Server",
    "approval_policy": "require_approval_all",
    "transport": "SSE",
    "description": "Reference implementation MCP server with all features",
    "request_headers": {
      "User-Agent": "MCP-Client/1.0",
      "Accept": "application/json"
    },
    "is_creator": true,
    "role": "admin",
    "created_at": 1751401457604,
    "updated_at": 1751401457604,
    "tool_approval_hashes": [],
    "dependent_agents": [],
    "config": {
      "tool_approval_hashes": [],
      "approval_policy": "require_approval_all",
      "name": "Everything MCP Server",
      "request_headers": {
        "User-Agent": "MCP-Client/1.0",
        "Accept": "application/json"
      },
      "description": "Reference implementation MCP server with all features",
      "transport": "SSE",
      "url": "https://raw.githubusercontent.com/modelcontextprotocol/server-everything/main/package.json"
    },
    "access_info": {
      "role": "admin",
      "creator_email": null,
      "creator_name": null,
      "is_creator": true
    },
    "metadata": {
      "owner_user_id": null,
      "created_at": 1751401457604
    }
  }
}

Authorizations

X-API-KEY
string
header
required

API Key for MCP server and external service authentication

X-API-SECRET
string
header
required

API Secret for MCP server and external service authentication

Body

application/json
config
object
required

Response

MCP server created successfully

message
string
status
string
error
string | null
data
object