SOsolvapay
Products

Bootstrap MCP product integration

Changed on

Creates an MCP-enabled product with a unified plans array, configures origin URL, and maps tools to plans in one request.

post/v1/sdk/products/mcp/bootstrap

Request

Request body

authApiKeystring
authHeaderNamestring
descriptionstring
imageUrlstring
mcpDomainstring
metadataobject
namestring
originUrlstring required
productTypestring

Response

MCP product bootstrapped successfully

mcpServerobject required

Created or updated MCP server identity

planMapobject required

Resolved plan mapping by bootstrap key

toolsAutoMappedboolean

True when tools were auto-discovered from origin because the request omitted tools

Example response

{
  "mcpServer": {
    "defaultPlanRef": "pln_FREE123",
    "id": "507f1f77bcf86cd799439011",
    "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
    "reference": "mcp_ABC123",
    "subdomain": "acme-docs",
    "url": "https://origin.example.com/mcp"
  },
  "planMap": {
    "free": {
      "name": "Free",
      "reference": "pln_FREE123"
    }
  },
  "product": {
    "config": {
      "deliveryMethod": "api",
      "fulfillmentType": "digital",
      "validityPeriod": 30
    },
    "mcp": {
      "defaultPlanRef": "pln_FREE123",
      "mcpProxyUrl": "https://acme-docs.mcp.solvapay.com/mcp",
      "mcpServerRef": "mcp_ABC123",
      "mcpSubdomain": "acme-docs",
      "originUrl": "https://origin.example.com/mcp"
    },
    "name": "AI Writing Assistant",
    "plans": [
      {
        "currency": "USD",
        "currencySymbol": "$",
        "description": "Best for teams getting started",
        "isActive": true,
        "name": "Starter",
        "price": 2999,
        "reference": "pln_1A2B3C4D",
        "requiresPayment": true,
        "status": "active",
        "type": "recurring"
      }
    ],
    "reference": "prd_1A2B3C4D",
    "status": "active"
  },
  "toolsAutoMapped": true
}

Changes

  • e13ee57d07a6Revision changes
    • breaking

      removed subschema #4 subschema #6 subschema #8 from the /// request property oneOf list

    • info

      added subschema #4 subschema #6 to the /// request property oneOf list

  • e38277a25e0cRevision changes
    • breaking

      removed the enum value top_up of the request property /////

    • info

      added the new draw_credits enum value to the request property /////