Create Mcp Server Connection

Create an MCP server spec and instance in one transaction.

post/v1/workspaces/{workspace}/mcp-server-instances/with-spec

Request

The document declares no server URL.
Auth
HTTP bearer
TypeScript
https://skmtc.dev/agentarea/apis/agentarea-api/docs/v1/workspaces/:workspace/mcp-server-instances/with-spec/post.ts
A function with typed inputs. Its response is checked against the schema.

workspacestring required

Slug of the workspace the request acts in

Successful Response

costobject nullable

created_atstring date-time required

descriptionstring nullable required

eventsobject nullable

idstring uuid required

is_ownerboolean

json_specobject required

last_dispatchobject nullable

managed_bystring nullable

namestring required

personalboolean

server_spec_idstring required

toolsobject[] nullable

transport'url' | 'docker' | 'command' | 'bundle' required

How a connection is reached: the instance's transport column, set once at creation.

updated_atstring date-time required

verificationobject required

Nov 10, 20264662804c264b Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Oct 19, 20261d8a3995ec6c Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status