Prepare conversion setup

Loading server catalog…. Download catalog

POSThttps://app.advarde.com/mcp

Prepare change

Available subject to your connection’s permissions.

Description: Inspect existing resources and prepare a frozen, resumable conversion setup. Reuses matching definitions; creates only missing resources. Review the plan then use ads_apply_change. Uncertain writes must be reconciled before another create.

Method: tools/call · ads_prepare_conversion_setup

Output: Tool data is returned in result.structuredContent and as JSON text in result.content. Inspect result.isError before using the result. Individual output fields depend on the operation.

Access: Requires the applicable write scopes, workspace role, and account permissions.

Review before applying

This tool prepares a proposal. Review the exact payload and obtain authorization before calling ads_apply_change. Preparation does not mean the upstream change has been applied.

Authentication

Use an MCP access token from MCP connections, or connect through OAuth. Send your token in the Authorization: Bearer header.

For full protocol initialization and tool discovery, use an MCP client. These examples show individual JSON-RPC requests.

Tool arguments

Send these fields inside params.arguments. The tool name is sent as params.name.

setup_idstringrequired

format: "uuid"

expected_revisionintegerrequired

minimum: 1

Full JSON Schema

{
  "type": "object",
  "properties": {
    "setup_id": {
      "type": "string",
      "format": "uuid"
    },
    "expected_revision": {
      "type": "integer",
      "minimum": 1
    }
  },
  "required": [
    "setup_id",
    "expected_revision"
  ],
  "additionalProperties": false
}

Responses

200Successful protocol response

Inspect result.isError for tool-level failures, even when the HTTP status is 200.

202Notification accepted

MCP notifications return no JSON-RPC response body.

400Invalid request

Check the JSON-RPC envelope, parameters, and protocol version.

406Not acceptable

Accept must include application/json and text/event-stream.

429Rate limited

Wait for the Retry-After interval before making another request.

401Unauthorized

A valid, unexpired MCP bearer token is required.

403Access denied

Your connection needs access to this workspace and the requested operation.

REQUEST URL · POST

https://app.advarde.com/mcp

Request headers

Authorization: Bearer $ADVARDE_MCP_TOKEN
Content-Type: application/json
Accept: application/json, text/event-stream
MCP-Protocol-Version: 2025-03-26

Tool arguments (JSON)

These values become params.arguments in the request body. Replace sample IDs and values with your own.

Full request body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ads_prepare_conversion_setup",
    "arguments": {
      "setup_id": "00000000-0000-4000-8000-000000000001",
      "expected_revision": 1
    }
  }
}

I reviewed and authorize this exact request to prepare a proposal.

RESPONSE

No request sent

The actual server response will appear here.

CODE EXAMPLE

cURL requestJSON-RPC 2.0

curl --request POST \
  --url 'https://app.advarde.com/mcp' \
  --header "Authorization: Bearer $ADVARDE_MCP_TOKEN" \
  --header 'Accept: application/json, text/event-stream' \
  --header 'Content-Type: application/json' \
  --header 'MCP-Protocol-Version: 2025-03-26' \
  --data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ads_prepare_conversion_setup",
    "arguments": {
      "setup_id": "00000000-0000-4000-8000-000000000001",
      "expected_revision": 1
    }
  }
}'

This endpoint uses stateless Streamable HTTP with JSON responses. Connect token performs initialization and discovery. Code examples show the individual request.