Retrieve an MCP server | Ara Documentation

{
  "id": "mcp-1234abcd5678efgh",
  "slug": "code-analysis-server",
  "name": "Code Analysis MCP Server",
  "icon": "https://cdn.ara.so/icons/code-analysis.png",
  "description": "Server providing static code analysis and linting capabilities.",
  "source": "https://github.com/ara-so/mcp-code-analysis",
  "transport": "http",
  "url": "https://mcp.ara.so/code-analysis",
  "command": null,
  "args": [
    "--verbose",
    "--max-warnings=10"
  ],
  "env": {
    "LOG_LEVEL": "info",
    "NODE_ENV": "production"
  },
  "headers": {
    "Authorization": "Bearer ara_abcdef1234567890"
  },
  "auth_type": "bearer",
  "secret_names": [
    "API_KEY",
    "WEBHOOK_SECRET"
  ],
  "access": "org-wide",
  "enabled": true,
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-04-10T12:45:00Z"
}

Returns a single org-level MCP server. Secret values are never returned.

_{Scope: plugins:read}

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.

Response

The 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

404

Not Found Error

$	curl https://api.ara.so/v3/organizations/orgId/mcp-servers/id \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"