v20

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-214885191.3 KB

Products

Bootstrap MCP product integration

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 body

authApiKeystring

authHeaderNamestring

descriptionstring

imageUrlstring

mcpDomainstring

metadataobject required

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",
    "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": [
      {
        "billingCycle": "monthly",
        "billingModel": "pre-paid",
        "creditsPerUnit": 1,
        "currency": "USD",
        "currencySymbol": "$",
        "freeUnits": 1000,
        "isActive": true,
        "limit": 10000,
        "measures": "requests",
        "meterRef": "mtr_1A2B3C4D",
        "price": 2999,
        "reference": "pln_1A2B3C4D",
        "requiresPayment": true,
        "setupFee": 500,
        "status": "active",
        "trialDays": 14
      }
    ],
    "reference": "prd_1A2B3C4D",
    "status": "active"
  },
  "toolsAutoMapped": true
}