Skip to main content
GET
/
api
/
servers
/
{serverId}
Get server details
curl --request GET \
  --url https://mcp.runalloy.com/api/servers/{serverId} \
  --header 'Authorization: Bearer <token>'
{
  "serverId": "<string>",
  "name": "<string>",
  "description": "<string>",
  "url": "<string>",
  "accessUrl": "<string>",
  "restrictions": {
    "connectors": {
      "mode": "allowlist",
      "allowedIds": [
        "<string>"
      ],
      "blockedIds": [
        "<string>"
      ]
    },
    "actions": {
      "mode": "allowlist",
      "allowedActions": [
        "<string>"
      ],
      "blockedActions": [
        "<string>"
      ]
    },
    "users": {
      "mode": "allowlist",
      "allowedIds": [
        "<string>"
      ],
      "blockedIds": [
        "<string>"
      ]
    }
  },
  "hasRestrictions": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization
string
header
required

Use either an Alloy API key or JWT token

Headers

x-alloy-userid
string

User ID (optional with API key)

Path Parameters

serverId
string
required

Server ID

Response

Server details

serverId
string

Unique server identifier

name
string

Server name

description
string

Server description

url
string

Base URL for API-authenticated access

accessUrl
string

Self-sufficient URL with embedded token

restrictions
object
hasRestrictions
boolean

Whether server has active restrictions

createdAt
string<date-time>
updatedAt
string<date-time>
I