Create Mcp Server Instance
Create a new MCP server instance.
Returns 201 for url (synchronous verification completed). Returns 202 for docker/command (background verification in progress).
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Slug of the workspace the request acts in
120^[a-z0-9]+(?:-[a-z0-9]+)*$Body
Payload for creating an MCP server instance.
The instance's transport (url, docker or command) is the one its server
spec declares; the response carries it as transport. json_spec
carries the instance's own configuration, e.g.
{"environment": {...}, "env_vars": [...]} or {"headers": {...}};
transport keys in it are ignored.
For URL-type instances the service synchronously verifies the endpoint;
docker/command kick off background verification.
Instance configuration (environment, env_vars, headers). Transport keys such as 'type' are ignored: the server spec declares the transport.
Display name for this MCP server instance (unique per workspace).
1 - 255ID of an existing MCP server spec to derive defaults from (env_schema, secret routing, etc.).
ID of an MCP auth config (OAuth/credentials) to attach.
URL instances only. Shared secret (at least 32 characters) AgentArea signs each tool call's context token with, so the server can trust which task, workspace and end user the call is for. Write-only: stored in the secret manager; the instance's json_spec shows context_signing: true instead.
32 - 512Optional human-readable description of the instance.
Response
Successful Response
How a connection is reached: the instance's transport column, set once at creation.
url, docker, command, bundle