Skip to main content
POST
/
v1
/
mcp-servers
/
{id}
cURL
curl --request POST \
  --url https://cloud.activepieces.com/api/v1/mcp-servers/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "tools": [
    {
      "type": "PIECE",
      "pieceMetadata": {
        "pieceName": "<string>",
        "pieceVersion": "<string>",
        "actionName": "<string>",
        "actionDisplayName": "<string>",
        "logoUrl": "<string>",
        "connectionExternalId": "<string>"
      }
    }
  ]
}'
{
  "id": "<string>",
  "created": "<string>",
  "updated": "<string>",
  "name": "<string>",
  "projectId": "<string>",
  "token": "<string>",
  "agentId": "<string>",
  "externalId": "<string>",
  "tools": [
    {
      "type": "PIECE",
      "id": "<string>",
      "created": "<string>",
      "updated": "<string>",
      "externalId": "<string>",
      "toolName": "<string>",
      "mcpId": "<string>",
      "pieceMetadata": {
        "pieceName": "<string>",
        "pieceVersion": "<string>",
        "actionName": "<string>",
        "actionDisplayName": "<string>",
        "logoUrl": "<string>",
        "connectionExternalId": "<string>"
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Use your api key generated from the admin console

Path Parameters

id
string
required

Body

application/json
name
string
tools
object[]
  • Option 1
  • Option 2

Response

200 - application/json

Default Response

id
string
required
created
string
required
updated
string
required
name
string
required
projectId
string
required
token
string
required
externalId
string
required
tools
object[]
required
  • Option 1
  • Option 2
agentId
string