{"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":{"email":"hello@wundercorp.co","url":"https://wundercorp.co","name":"WunderCorp, Inc."}},"servers":[{"url":"https://api.wundership.com"}],"tags":[{"description":"Paid Wundership endpoints that agents can invoke after MPP payment.","name":"Machine Payments"},{"description":"Software planning and implementation direction for agent callers.","name":"App Planning"},{"description":"BuilderStudio preview and app-generation support endpoints.","name":"BuilderStudio"},{"description":"Paid AI generation utilities.","name":"AI Generation"},{"description":"Paid commerce metadata generation utilities.","name":"Commerce"}],"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":{"preferred_stack":"Next.js, Spring Boot, PostgreSQL, Stripe","target_customer":"Founders, AI builders, and autonomous agents","output_format":"implementation_plan","constraints":["Use a machine-payment endpoint","Return clear implementation phases"],"project_name":"Agent Market","prompt":"Build a marketplace for AI agents that can buy and sell paid API calls."}}},"schema":{"type":"object","additionalProperties":false,"required":["prompt"],"properties":{"preferred_stack":{"description":"Preferred technical stack, framework, language, or deployment target.","type":"string"},"target_customer":{"description":"Who the app or software plan is for.","type":"string"},"output_format":{"description":"Requested output style, such as implementation_plan, product_outline, or feature_map.","type":"string"},"constraints":{"items":{"type":"string"},"type":"array","description":"Hard requirements, limits, or product constraints."},"project_name":{"description":"Optional project or product name.","type":"string"},"prompt":{"description":"Software idea, product request, or agent task to turn into an implementation-ready plan.","type":"string"}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"wundership_plan","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true,"properties":{"buildPhases":{"items":{"type":"string"},"type":"array"},"recommendedNextPaidCall":{"additionalProperties":true,"type":"object"},"risks":{"items":{"type":"string"},"type":"array"},"architecture":{"items":{"type":"string"},"type":"array"},"productBrief":{"type":"string"}}},"ok":{"type":"boolean"},"productName":{"example":"Wundership app plan","type":"string"},"receipt":{"type":"string"}}}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"description":"Payment required","headers":{"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}},"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"display":"1.00","currency":"USD","minorUnits":100},"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":{"mode":"fixed","currency":"USD","amount":"1.000000"},"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":{"output_format":{"description":"Optional requested output format.","type":"string"},"context":{"description":"Optional structured context for the request.","type":"object","additionalProperties":true},"prompt":{"description":"Agent task or generation prompt for this paid Wundership endpoint.","type":"string"}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"builder_preview","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"BuilderStudio preview","type":"string"},"receipt":{"type":"string"}}}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"description":"Payment required","headers":{"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}},"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"display":"5.00","currency":"USD","minorUnits":500},"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":{"mode":"fixed","currency":"USD","amount":"5.000000"},"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":{"output_format":{"description":"Optional requested output format.","type":"string"},"context":{"description":"Optional structured context for the request.","type":"object","additionalProperties":true},"prompt":{"description":"Agent task or generation prompt for this paid Wundership endpoint.","type":"string"}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"image_generation","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"Image generation","type":"string"},"receipt":{"type":"string"}}}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"description":"Payment required","headers":{"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}},"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"display":"1.00","currency":"USD","minorUnits":100},"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":{"mode":"fixed","currency":"USD","amount":"1.000000"},"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":{"output_format":{"description":"Optional requested output format.","type":"string"},"context":{"description":"Optional structured context for the request.","type":"object","additionalProperties":true},"prompt":{"description":"Agent task or generation prompt for this paid Wundership endpoint.","type":"string"}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"listing_from_image","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"Listing from image","type":"string"},"receipt":{"type":"string"}}}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"description":"Payment required","headers":{"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}},"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"display":"0.75","currency":"USD","minorUnits":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":{"mode":"fixed","currency":"USD","amount":"0.750000"},"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":{"output_format":{"description":"Optional requested output format.","type":"string"},"context":{"description":"Optional structured context for the request.","type":"object","additionalProperties":true},"prompt":{"description":"Agent task or generation prompt for this paid Wundership endpoint.","type":"string"}}}}}},"responses":{"200":{"description":"Paid request completed","content":{"application/json":{"schema":{"type":"object","required":["ok","provider","productKey","paymentVerified","result"],"properties":{"generatedAt":{"format":"date-time","type":"string"},"provider":{"example":"wundership","type":"string"},"productKey":{"example":"chat_completion","type":"string"},"paymentVerified":{"type":"boolean"},"result":{"type":"object","additionalProperties":true},"ok":{"type":"boolean"},"productName":{"example":"Chat completion","type":"string"},"receipt":{"type":"string"}}}}}},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}},"description":"Payment required","headers":{"WWW-Authenticate":{"description":"Machine-payment challenge header when a compatible payment rail is active.","schema":{"type":"string"}},"X-Wundership-Agent-Price":{"description":"Human-readable price for the paid endpoint.","schema":{"type":"string"}}}},"502":{"description":"Paid forwarding failed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-agent-price":{"display":"0.50","currency":"USD","minorUnits":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":{"mode":"fixed","currency":"USD","amount":"0.500000"},"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":{"securitySchemes":{"mppPayment":{"type":"http","bearerFormat":"MPP payment authorization","scheme":"bearer","description":"Authorization header supplied by an MPP-compatible agent or proxy after payment. Discovery endpoints are public; paid endpoints return 402 before payment."}},"schemas":{"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"fallback":{"type":"string"},"error":{"type":"string"}},"additionalProperties":true},"PaymentRequired":{"type":"object","required":["error","status","resource","amount","payment"],"properties":{"error":{"example":"payment_required","type":"string"},"type":{"example":"machine_payment_required","type":"string"},"status":{"example":402,"type":"integer"},"protocols":{"items":{"type":"string"},"type":"array"},"provider":{"example":"wundership","type":"string"},"resource":{"format":"uri","type":"string"},"product":{"additionalProperties":true,"type":"object"},"amount":{"additionalProperties":true,"type":"object"},"payment":{"additionalProperties":true,"type":"object"},"requestId":{"type":"string"}}}}}}