Create an MCP server | Ara Documentation

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

{
  "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
  "slug": "codeanalysisserver",
  "name": "CodeAnalysisServer",
  "icon": "https://example.com/icons/code-analysis.svg",
  "description": "Server for analyzing code quality and style.",
  "source": "internal",
  "transport": "http",
  "url": "https://mcp.codeanalysis.example.com/api",
  "command": "node",
  "args": [
    "server.js",
    "--port",
    "8080"
  ],
  "env": {},
  "headers": {},
  "auth_type": "none",
  "secret_names": [
    "api_key"
  ],
  "access": "org",
  "enabled": true,
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}

Registers an org-level MCP server. Secret values supplied in secrets 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.

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 created 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

400

Bad Request Error

403

Forbidden Error