Organization

Provision MCP onboarding bundle

Creates welcome vault + sample secret, MCP agent, and a policy on the vault. Returns one-time API key and stdio MCP config.

The grant is ** only when the welcome vault is newly created. If an org already has a vault named default, it is reused and the agent is granted examples/** instead — enough to read the sample it is asked to verify with, without exposing secrets already kept there.

Subject to agent.create control-plane consensus; see approval_id.

post/v1/onboarding/provision

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/onboarding/provision
  • Auth: HTTP bearer

Request body

agent_namestring
clientstring
approval_idstring uuid

Approval satisfying an agent.create control-plane consensus policy, if the org has one. Same field and meaning as on POST /v1/agents: the first call returns 202 with the approval to collect, and the retry passes its id here.

guidedboolean

Seeds getting-started/** instead of examples/** in the shared default vault — the guided onboarding wizard's own sample content, kept distinguishable from the MCP-connect developer flow's.

Response

Provisioned resources

agent_idstring uuid required
api_keystring required
vault_idstring uuid required
mcp_stdio_configobject required
verify_promptstring required

Changes

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