Update an MCP server | Ara Documentation

curl -X PATCH https://api.ara.so/v3/organizations/orgId/mcp-servers/id \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Agent Control Server",
  "transport": "http"
}'

{
  "id": "mcp-1234abcd",
  "slug": "agent-control-server",
  "name": "Agent Control Server",
  "icon": "🤖",
  "description": "Handles communication between agents and the cloud platform.",
  "source": "internal",
  "transport": "http",
  "url": "https://agents.example.com/api",
  "command": "start-agent-server",
  "args": [
    "--verbose"
  ],
  "env": {},
  "headers": {},
  "auth_type": "none",
  "secret_names": [
    "api_key"
  ],
  "access": "org-admin",
  "enabled": true,
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}

Partial update. Send only the fields you want to change. Secret values are stored write-only and never returned.

_{Scope: plugins:write}

Authentication

AuthorizationBearer

Your ara_ API key from Settings > Ara API. Keys are capability-scoped: run, plugins:read, secrets:read, secrets:write, sessions:read, knowledge:read, repos:read, repos:write, reviews:read, reviews:write, analytics:read, org:read, org:write, attachments:read, attachments:write, plugins:write, guardrails:read, guardrails:write.

Path parameters

orgIdstringRequired

Organization id or slug. Resolve it with GET /v3/self.

idstringRequired

The MCP server id.

Request

This endpoint expects an object.

namestringRequired

transportenumRequired

iconstringOptional

descriptionstringOptional

urlstringOptional

commandstringOptional

argslist of stringsOptional

envmap from strings to stringsOptional

headersmap from strings to stringsOptional

auth_typeenumOptional

secretsmap from strings to stringsOptional

Write-only. Secret values to store for this server. Never returned in any response.

enabledbooleanOptional

Response

The updated MCP server.

idstring

slugstring

namestring

iconstring or null

descriptionstring

sourcestring

transportenum

urlstring or null

commandstring or null

argslist of strings

envmap from strings to strings

headersmap from strings to strings

auth_typeenum

secret_nameslist of strings

The names of the secrets configured for this server. Secret values are write-only and are never returned.

accessstring

enabledboolean

created_atdatetime

updated_atdatetime

Errors

403

Forbidden Error

404

Not Found Error