{"openapi":"3.1.0","info":{"title":"Wundership MPP API","version":"2026-06-24","description":"Public OpenAPI surface for Wundership machine-paid agent requests. Unpaid requests return HTTP 402 Payment Required.","guidance":"Use POST /mpp/plan with a JSON body containing a prompt or idea to buy a structured Wundership software plan. Discovery endpoints are public. Paid operations declare x-payment-info and return HTTP 402 Payment Required until payment is authorized. After payment, retry the same request with the payment authorization or verified proxy headers described by the payment challenge.","x-guidance":"Use POST /mpp/plan with a JSON body containing a prompt or idea to buy a structured Wundership software plan. Discovery endpoints are public. Paid operations declare x-payment-info and return HTTP 402 Payment Required until payment is authorized. After payment, retry the same request with the payment authorization or verified proxy headers described by the payment challenge.","contact":{"name":"WunderCorp, Inc.","url":"https://wundercorp.co","email":"hello@wundercorp.co"}},"servers":[{"url":"https://api.wundership.com"}],"tags":[{"name":"Machine Payments","description":"Paid Wundership endpoints that agents can invoke after MPP payment."},{"name":"App Planning","description":"Software planning and implementation direction for agent callers."},{"name":"BuilderStudio","description":"BuilderStudio preview and app-generation support endpoints."},{"name":"AI Generation","description":"Paid AI generation utilities."},{"name":"Commerce","description":"Paid commerce metadata generation utilities."}],"paths":{"/mpp/plan":{"post":{"tags":["Machine Payments","App Planning"],"summary":"Wundership app plan","description":"Generate a structured software plan, product outline, feature map, and implementation-ready app direction. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postWundershipPlan","requestBody":{"required":true,"content":{"application/json":{"examples":{"softwarePlan":{"summary":"Generate an implementation-ready app plan","value":{"prompt":"Build a marketplace for AI agents that can buy and sell paid API calls.","project_name":"Agent Market","constraints":["Use a machine-payment endpoint","Return clear implementation phases"],"output_format":"implementation_plan","target_customer":"Founders, AI builders, and autonomous agents","preferred_stack":"Next.js, Spring Boot, PostgreSQL, Stripe"}}},"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"prompt":{"type":"string","description":"Software idea, product request, or agent task to turn into an implementation-ready plan."},"project_name":{"type":"string","description":"Optional project or product name."},"constraints":{"description":"Hard requirements, limits, or product constraints.","type":"array","items":{"type":"string"}},"output_format":{"type":"string","description":"Requested output style, such as implementation_plan, product_outline, or feature_map."},"target_customer":{"type":"string","description":"Who the app or software plan is for."},"preferred_stack":{"type":"string","description":"Preferred technical stack, framework, language, or deployment target."}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"receipt":{"type":"string"},"productName":{"type":"string","example":"Wundership app plan"},"ok":{"type":"boolean"},"result":{"type":"object","additionalProperties":true,"properties":{"productBrief":{"type":"string"},"architecture":{"type":"array","items":{"type":"string"}},"risks":{"type":"array","items":{"type":"string"}},"recommendedNextPaidCall":{"type":"object","additionalProperties":true},"buildPhases":{"type":"array","items":{"type":"string"}}}},"paymentVerified":{"type":"boolean"},"productKey":{"type":"string","example":"wundership_plan"},"provider":{"type":"string","example":"wundership"},"generatedAt":{"type":"string","format":"date-time"}}}}}},"402":{"headers":{"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}}},"description":"Payment required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"minorUnits":100,"currency":"USD","display":"1.00"},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"amount":"1.000000","currency":"USD","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"1.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"100","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/builder/preview":{"post":{"tags":["Machine Payments","BuilderStudio"],"summary":"BuilderStudio preview","description":"Prepare a BuilderStudio preview package for a product idea. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postBuilderPreview","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"prompt":"Complete this Wundership task for an agent caller.","output_format":"json"}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."},"context":{"additionalProperties":true,"type":"object","description":"Optional structured context for the request."},"output_format":{"type":"string","description":"Optional requested output format."}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"receipt":{"type":"string"},"productName":{"type":"string","example":"BuilderStudio preview"},"ok":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"paymentVerified":{"type":"boolean"},"productKey":{"type":"string","example":"builder_preview"},"provider":{"type":"string","example":"wundership"},"generatedAt":{"type":"string","format":"date-time"}}}}}},"402":{"headers":{"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}}},"description":"Payment required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"minorUnits":500,"currency":"USD","display":"5.00"},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"amount":"5.000000","currency":"USD","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"5.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"500","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/images/generate":{"post":{"tags":["Machine Payments","AI Generation"],"summary":"Image generation","description":"Generate an image from a prompt after machine payment. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postImageGeneration","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"prompt":"Complete this Wundership task for an agent caller.","output_format":"json"}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."},"context":{"additionalProperties":true,"type":"object","description":"Optional structured context for the request."},"output_format":{"type":"string","description":"Optional requested output format."}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"receipt":{"type":"string"},"productName":{"type":"string","example":"Image generation"},"ok":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"paymentVerified":{"type":"boolean"},"productKey":{"type":"string","example":"image_generation"},"provider":{"type":"string","example":"wundership"},"generatedAt":{"type":"string","format":"date-time"}}}}}},"402":{"headers":{"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}}},"description":"Payment required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"minorUnits":100,"currency":"USD","display":"1.00"},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"amount":"1.000000","currency":"USD","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"1.000000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"100","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/listings/from-image":{"post":{"tags":["Machine Payments","Commerce"],"summary":"Listing from image","description":"Generate commerce listing metadata from image input after machine payment. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postListingFromImage","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"prompt":"Complete this Wundership task for an agent caller.","output_format":"json"}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."},"context":{"additionalProperties":true,"type":"object","description":"Optional structured context for the request."},"output_format":{"type":"string","description":"Optional requested output format."}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"receipt":{"type":"string"},"productName":{"type":"string","example":"Listing from image"},"ok":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"paymentVerified":{"type":"boolean"},"productKey":{"type":"string","example":"listing_from_image"},"provider":{"type":"string","example":"wundership"},"generatedAt":{"type":"string","format":"date-time"}}}}}},"402":{"headers":{"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}}},"description":"Payment required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"minorUnits":75,"currency":"USD","display":"0.75"},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"amount":"0.750000","currency":"USD","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"0.750000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"75","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}},"/mpp/chat/completions":{"post":{"tags":["Machine Payments","AI Generation"],"summary":"Chat completion","description":"Generate a chat completion after machine payment. This is a paid machine-payment endpoint. Unpaid calls return HTTP 402 Payment Required with machine-payment metadata. Retry the same request after payment authorization.","operationId":"postChatCompletion","requestBody":{"required":true,"content":{"application/json":{"examples":{"default":{"summary":"Invoke paid endpoint","value":{"prompt":"Complete this Wundership task for an agent caller.","output_format":"json"}}},"schema":{"type":"object","additionalProperties":true,"required":["prompt"],"properties":{"prompt":{"type":"string","description":"Agent task or generation prompt for this paid Wundership endpoint."},"context":{"additionalProperties":true,"type":"object","description":"Optional structured context for the request."},"output_format":{"type":"string","description":"Optional requested output format."}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"receipt":{"type":"string"},"productName":{"type":"string","example":"Chat completion"},"ok":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"paymentVerified":{"type":"boolean"},"productKey":{"type":"string","example":"chat_completion"},"provider":{"type":"string","example":"wundership"},"generatedAt":{"type":"string","format":"date-time"}}}}}},"402":{"headers":{"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}},"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}}},"description":"Payment required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"minorUnits":50,"currency":"USD","display":"0.50"},"x-machine-payment-protocols":["mpp"],"x-machine-payment-rails":[{"key":"stripe_spt","method":"stripe","intent":"charge","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"],"description":"Stripe Shared Payment Token rail for card and Link machine payments."}],"x-payment-info":{"price":{"amount":"0.500000","currency":"USD","mode":"fixed"},"pricingMode":"fixed","currency":"USD","amount":"0.500000","unit":"request","protocols":[{"mpp":{"method":"stripe","intent":"charge","currency":"USD","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}}],"offers":[{"method":"stripe","intent":"charge","amount":"50","currency":"usd","networkId":"profile_61UuYA3H1dpGiR9soA6UuYA20RSQieSC6KcBS11OK1dI","paymentMethodTypes":["card","link"]}]}}}},"components":{"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"string"},"fallback":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true},"PaymentRequired":{"type":"object","required":["error","status","resource","amount","payment"],"properties":{"error":{"type":"string","example":"payment_required"},"type":{"type":"string","example":"machine_payment_required"},"status":{"type":"integer","example":402},"protocols":{"type":"array","items":{"type":"string"}},"provider":{"type":"string","example":"wundership"},"resource":{"type":"string","format":"uri"},"product":{"type":"object","additionalProperties":true},"amount":{"type":"object","additionalProperties":true},"payment":{"type":"object","additionalProperties":true},"requestId":{"type":"string"}}}},"securitySchemes":{"mppPayment":{"description":"Authorization header supplied by an MPP-compatible agent or proxy after payment. Discovery endpoints are public; paid endpoints return 402 before payment.","scheme":"bearer","bearerFormat":"MPP payment authorization","type":"http"}}}}