{"openapi":"3.1.0","info":{"title":"Creatorpay API","version":"0.1.0","description":"A fully local creator income-stream reference: ad revenue, sponsorship, affiliate marketing, membership/subscription and digital-product mechanics, FTC disclosure basics, income calculators using user-supplied numbers, diversification tips, tax awareness, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://creatorpay.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/creatorpay/docs"},"termsOfService":"https://connectorbay.com/creatorpay/terms"},"servers":[{"url":"https://creatorpay.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/creatorpay/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/income_stream_explainer":{"post":{"operationId":"income_stream_explainer","summary":"Explains how one of 5 creator income streams typically works — ad revenue, sponsorship, affiliate marketing,","description":"Explains how one of 5 creator income streams typically works — ad revenue, sponsorship, affiliate marketing,\n    membership/subscription, or digital products — including what drives earnings and key variables. No dollar\n    figures for any real platform are asserted. Use for \"how does ad revenue work for creators\", \"how does\n    affiliate marketing work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"stream":{"description":"An income stream.","examples":["affiliate_marketing"],"minLength":1,"title":"Stream","type":"string"}},"required":["stream"],"title":"income_stream_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/income_stream_list":{"post":{"operationId":"income_stream_list","summary":"Every creator income stream this reference explains. Use for \"what income streams do creators typically have\".","description":"Every creator income stream this reference explains. Use for \"what income streams do creators typically have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"income_stream_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/sponsorship_deal_checklist":{"post":{"operationId":"sponsorship_deal_checklist","summary":"What to negotiate in a brand sponsorship deal (fee structure, usage rights, exclusivity, deliverables,","description":"What to negotiate in a brand sponsorship deal (fee structure, usage rights, exclusivity, deliverables,\n    approval rounds) plus the FTC disclosure requirement that applies. Use for \"what should I negotiate in a\n    sponsorship deal\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"sponsorship_deal_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/affiliate_commission_calculator":{"post":{"operationId":"affiliate_commission_calculator","summary":"Computes affiliate commission per sale and total, using ONLY the sale price and commission rate you supply —","description":"Computes affiliate commission per sale and total, using ONLY the sale price and commission rate you supply —\n    never a real program's actual published rate. Use for \"if my affiliate rate is 8% and I sell $500, what's my\n    commission\", \"commission on 20 sales at $30 each and a 10% rate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sale_price":{"description":"The price of the item sold.","examples":[50],"exclusiveMinimum":0,"maximum":10000000,"title":"Sale Price","type":"number"},"commission_pct":{"description":"Your commission rate as a percentage.","examples":[8],"exclusiveMinimum":0,"maximum":100,"title":"Commission Pct","type":"number"},"num_sales":{"default":1,"description":"Number of sales to calculate total commission for.","exclusiveMinimum":0,"maximum":10000000,"title":"Num Sales","type":"integer"}},"required":["sale_price","commission_pct"],"title":"affiliate_commission_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/membership_revenue_calculator":{"post":{"operationId":"membership_revenue_calculator","summary":"Computes monthly gross and net membership revenue, using ONLY the member count, price, and platform-cut","description":"Computes monthly gross and net membership revenue, using ONLY the member count, price, and platform-cut\n    percentage you supply. Use for \"if I have 500 members paying $5 a month, what's my revenue after a 10%\n    platform cut\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"num_members":{"description":"Number of paying members.","examples":[500],"exclusiveMinimum":0,"maximum":100000000,"title":"Num Members","type":"integer"},"monthly_price":{"description":"Monthly price per member.","examples":[5],"exclusiveMinimum":0,"maximum":1000000,"title":"Monthly Price","type":"number"},"platform_cut_pct":{"default":0,"description":"The platform's percentage cut, if any.","exclusiveMaximum":100,"minimum":0,"title":"Platform Cut Pct","type":"number"}},"required":["num_members","monthly_price"],"title":"membership_revenue_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/digital_product_net_earnings":{"post":{"operationId":"digital_product_net_earnings","summary":"Computes net earnings per unit and total for a digital product, using ONLY the price and fee percentages you","description":"Computes net earnings per unit and total for a digital product, using ONLY the price and fee percentages you\n    supply — plug in your own platform's and payment processor's current published rates. Use for \"if I sell a $49\n    course with a 2.9%+$0.30 processing fee and no platform cut, what do I net per sale\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"price":{"description":"Sale price of the digital product.","examples":[49],"exclusiveMinimum":0,"maximum":1000000,"title":"Price","type":"number"},"payment_processing_pct":{"description":"Your payment processor's percentage fee.","examples":[2.9],"exclusiveMaximum":100,"minimum":0,"title":"Payment Processing Pct","type":"number"},"payment_processing_flat":{"description":"Your payment processor's flat per-transaction fee.","examples":[0.3],"minimum":0,"title":"Payment Processing Flat","type":"number"},"platform_cut_pct":{"default":0,"description":"A marketplace's percentage cut, if sold through one.","exclusiveMaximum":100,"minimum":0,"title":"Platform Cut Pct","type":"number"},"units_sold":{"default":1,"description":"Number of units sold.","exclusiveMinimum":0,"maximum":100000000,"title":"Units Sold","type":"integer"}},"required":["price","payment_processing_pct","payment_processing_flat"],"title":"digital_product_net_earningsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/ftc_disclosure_basics":{"post":{"operationId":"ftc_disclosure_basics","summary":"The FTC's endorsement-disclosure rule, live-verified against ftc.gov: when disclosure is required, which","description":"The FTC's endorsement-disclosure rule, live-verified against ftc.gov: when disclosure is required, which\n    language counts as clear vs. inadequate, placement requirements, and who's responsible. Use for \"what counts as\n    a clear FTC disclosure\", \"do I have to disclose free products I get from brands\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"ftc_disclosure_basicsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/income_diversification_tips":{"post":{"operationId":"income_diversification_tips","summary":"General advice on spreading creator income across multiple streams to reduce platform/algorithm risk. Use","description":"General advice on spreading creator income across multiple streams to reduce platform/algorithm risk. Use\n    for \"should I rely on one income stream\", \"how do creators diversify their income\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"income_diversification_tipsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/creator_tax_awareness":{"post":{"operationId":"creator_tax_awareness","summary":"General US tax-filing awareness for creator income (not tax advice): free products count as taxable income","description":"General US tax-filing awareness for creator income (not tax advice): free products count as taxable income\n    at fair market value, 1099 forms, and the recommendation to consult a tax professional. Use for \"do I owe taxes\n    on free products I get as a creator\", \"is affiliate income taxable\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"creator_tax_awarenessArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/creatorpay_glossary":{"post":{"operationId":"creatorpay_glossary","summary":"Definitions of creator-economy terms: CPM, RPM, affiliate link, cookie window, payout threshold, chargeback,","description":"Definitions of creator-economy terms: CPM, RPM, affiliate link, cookie window, payout threshold, chargeback,\n    1099-NEC, 1099-K, brand deal, UGC licensing, material connection. Use for \"what's RPM\", \"what's a material\n    connection\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"creatorpay_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}