Catalog and payments

MCP tools for products, perks, store product mappings, history imports and payment sources.

These tools let an agent manage what people buy and how purchases reach Voidhash: products, perks, store product mappings and payment sources.

Products and perks

Key access: Products; Entitlements for perks.

Tool	What it does
`list_products`	Products with their perks, store products, offer IDs and whether they can be bought.
`create_product`	Adds a subscription, one-time or consumable product.
`update_product`	Renames a product or changes its slug. Asks first for a new slug.
`delete_product`	Deletes a product no store product is mapped to. Asks first.
`list_perks`	Perks with the products that grant each.
`create_perk`	Adds a perk.
`set_product_perks`	Makes a product grant exactly the listed perks. Asks first when removing one.

Payment providers

Key access: Store credentials; Purchases to record, refund and cancel payment source purchases. Connecting the App Store, Google Play or Stripe happens in Studio or the CLI.

Tool	What it does
`list_payment_providers`	Each provider's health: enabled, store products read and mapped, purchases waiting.
`test_payment_provider`	Checks saved credentials, or calls each payment source endpoint.
`list_store_products`	Store products with the product each is mapped to.
`map_store_product`	Maps a store product to a product. Asks first when moving a mapping.
`unmap_store_product`	Removes a mapping. Asks first when it's active.
`import_purchase_history`	Imports Stripe's or a payment source's earlier purchases in the background.
`cancel_purchase_history_import`	Stops a running import; what it recorded stays.
`create_payment_source`	Adds a payment source and returns its signing secret once.
`update_payment_source`	Renames, enables or disables a source, or changes its endpoints and secrets. Asks first when disabling, disconnecting or rotating.
`delete_payment_source`	Deletes a payment source. Asks first.
`record_payment_source_transaction`	Records a charge or refund a payment source took. Asks first for a refund.
`record_payment_source_subscription`	Records a subscription's state at a payment source. Asks first when it ends access.
`refund_payment_source_transaction`	Refunds a charge through the source's endpoint. Asks first.
`cancel_payment_source_subscription`	Cancels a subscription through the source's endpoint. Asks first.

Example

Add a yearly plan that grants premium, and map it to com.example.pro.annual.

The agent calls create_product, set_product_perks, then list_store_products and map_store_product.

Next steps

Products and perks: how products, perks and store products relate.
Payment providers (Help center): connect a store in Studio.
Paywalls: sell the products.

Something wrong or missing on this page? Tell us by email or on Discord.