Create Robot MCP server

POST/robots/mcp-servers

Configure an external streamable HTTP MCP server for Robot tool discovery.

Authorization

storyden-session<token>

In: cookie

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

slug?string

Optional immutable namespace. If omitted, Storyden derives one from the name.

description?string

endpoint_url*string

oauth_remote_connection_id?Identifier

Optional remote OAuth connection that supplies the Bearer token for this MCP server after authorization completes.

enabled?boolean

bearer_token?string

Write-only Bearer token for the MCP server.

Response Body

`application/json`

curl -X POST "https://example.com/robots/mcp-servers" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "endpoint_url": "http://example.com"  }'

{
  "id": "cc5lnd2s1s4652adtu50",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "deletedAt": "2019-08-24T14:15:22Z",
  "misc": {},
  "name": "string",
  "slug": "string",
  "description": "string",
  "endpoint_url": "http://example.com",
  "oauth_remote_connection_id": "cc5lnd2s1s4652adtu50",
  "enabled": true,
  "has_bearer_token": true,
  "has_oauth_token": true,
  "last_refreshed_at": "2019-08-24T14:15:22Z",
  "last_error": "string",
  "tools": [
    {
      "id": "string",
      "remote_name": "string",
      "callable_name": "string",
      "title": "string",
      "description": "string",
      "enabled": true,
      "available": true,
      "last_seen_at": "2019-08-24T14:15:22Z"
    }
  ]
}

Empty

{
  "type": "string",
  "title": "string",
  "detail": "string",
  "trace_id": "string",
  "metadata": {}
}

Create Robot MCP server

Authorization

Request Body

Response Body

200application/json

400

401

403

defaultapplication/json

`application/json`

`application/json`