Connections

Agent asks its principal to connect an MCP server

Opens a connection consent agreement in the working chat: the user approves it like any agreement, and on approval the server is connected (if needed) and this agent is granted the listed tools. The agent learns the outcome from its inbox.

post/connections/mcp/requests

Request

  • Base URL: https://api.ziggsai.com
  • URL: https://api.ziggsai.com/connections/mcp/requests
  • Auth: HTTP bearer

Request body

serverUrlstring required

Remote MCP server URL (https)

toolsstring[] required

Tool names the agent wants (become allowed_actions caveats)

reasonstring

Plain-language reason shown to the user

chatIdstring required

Working chat the consent request is opened into, so it renders as an approvable card there.

recipientIdstring

Who to ask: one of the people the work brief offers for this wake (workBrief.actingFor.customer.id for their own accounts, or .operator.id for tools the agent brings). Required (the per-user relay may send it as X-On-Behalf-Of-User instead); a pick outside them is refused and the refusal lists them.

Response

Created

messagestring required

The same, as one sentence to pass on.

agreementIdstring required

Example response

{
  "message": "Sent to Ido. Ido approves it in this room."
}

Changes

No recorded changes to this operation across all 1 revision of this API.