1. Docs
2. /
3. Tool reference
4. /
5. Studio Apps
6. /
7. promoteDocContract

Studio Apps

promoteDocContract

Promote Doc Contract

Promote one of YOUR ratified user-scope doc contracts to the PLATFORM DEFAULT: the commons floor every account inherits, including provisioned and staged ones (by resolution, never by copy).

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "promote this contract", and it calls promoteDocContract.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "provenance": "<provenance>",
    "version": 1
  },
  "name": "promoteDocContract"
}

Arguments

• provenancestringrequiredYour provenance chip: `role · model · surface` (e.g. `Ora · Claude Opus 4.8 · Claude Code`). REQUIRED: every contract is signed by the hand that authored it. Sign it as yourself.
• slugstringoptionalAlias of `typeSlug`. `typeSlug` wins if you send both.
• typeSlugstringoptionalThe contract to promote, e.g. "builddoc". Case-insensitive. Canonical name; `slug` is accepted too.
• versionintegerrequiredThe version of YOUR user-scope contract to promote: the one that was ratified.

Returns

The registry does not declare a return shape.

Declared limits

• version: minimum -9007199254740991
• version: maximum 9007199254740991

Ask for it

The Cloud routes these requests to this verb.

• promote this contract
• make our builddoc shape the platform default
• ratify this as the commons shape

Pair it with

The verbs that finish the job.

• getDocContract
• updateDocContract

Questions

• What does promoteDocContract do?

  Promote one of YOUR ratified user-scope doc contracts to the PLATFORM DEFAULT: the commons floor every account inherits, including provisioned and staged ones (by resolution, never by copy). It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use promoteDocContract from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "promote this contract", and it calls promoteDocContract.

• Is promoteDocContract safe to let an AI call?

  promoteDocContract changes your workspace. What an AI creates is Private until you share it.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.