Skip to main content
POST
/
mcp
/
{serverId}
/
{accessToken}
curl --request POST \
  --url https://mcp.runalloy.com/mcp/{serverId}/{accessToken} \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": "1"
}'
{
  "jsonrpc": "2.0",
  "result": {
    "tools": [
      {
        "name": "list_connectors_alloy",
        "description": "List available platform connectors",
        "inputSchema": {
          "type": "object",
          "properties": {
            "category": {
              "type": "string",
              "description": "Filter by category"
            }
          }
        }
      }
    ]
  },
  "id": "1"
}

Authorizations

​
Authorization
string
header
required

Use either an Alloy API key or JWT token

Headers

​
Content-Type
string
default:application/json
required

Request content type

​
Accept
string
default:application/json, text/event-stream
required

Response format - must include text/event-stream for MCP

​
x-alloy-user-token
string

JWT token for user isolation (optional)

​
x-alloy-userid
string

Override user ID (optional)

​
x-credential-id
string

Specific credential to use (optional)

​
x-redirect-uri
string

OAuth redirect URI for credential creation (optional)

Path Parameters

​
serverId
string
required

Server ID

​
accessToken
string
required

Access token

Body

application/json
​
jsonrpc
enum<string>
required
Available options:
2.0
​
method
enum<string>
required
Available options:
tools/list,
tools/call,
resources/list,
resources/read,
prompts/list,
prompts/get
​
id
string
required
​
params
object

Response

MCP response

​
jsonrpc
enum<string>
Available options:
2.0
​
result
object
​
error
object
​
id
string
⌘I