Overview
POST/persona/mcp-serversregistry

Register a new third-party MCP server (site-admin)

Create a record in mcp-servers.

Auth: bearerAuth — calls run as the authenticated user.

Request body

application/json · optional

  • slugstring

    The globally-unique `<server>` handle in `mcp.<server>.<tool>`

  • namestring
  • urlstring

    The remote MCP server's http(s) endpoint URL

  • authSecretoptionalstring

    Optional per-server bearer secret; stored encrypted, never returned

  • enabledoptionalboolean

    Opt-in; defaults to disabled (contributes no tools until enabled)

Example
{
  "slug": "string",
  "name": "string",
  "url": "string",
  "authSecret": "string",
  "enabled": false
}
Responses
201

the registered server (secret redacted)

  • serverRegistryAgentMcpServer
Example
{
  "server": {
    "id": "string",
    "slug": "string",
    "name": "string",
    "url": "string",
    "enabled": true,
    "hasAuthSecret": true,
    "createdBy": "string",
    "createdAt": "string",
    "updatedAt": "string"
  }
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
403

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
409

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X POST "https://api.agenticdeveloperhub.com/persona/mcp-servers" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "slug": "string",
  "name": "string",
  "url": "string",
  "authSecret": "string",
  "enabled": false
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/persona/mcp-servers", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"slug\": \"string\",\n  \"name\": \"string\",\n  \"url\": \"string\",\n  \"authSecret\": \"string\",\n  \"enabled\": false\n}",
});
const data = await res.json();