Prompt-driven setup

Connect and configure any marketplace connector by asking your coding agent. The full lifecycle is exposed as MCP tools.

The entire marketplace lifecycle (connect, map, validate, activate, test) is exposed through the CashSDK MCP server, so you can wire up a billing backend or integration by asking your agent in natural language. No dashboard clicking, no glue code.

Point the MCP server at the marketplace service with CASHSDK_MARKETPLACE_URL and CASHSDK_MARKETPLACE_TOKEN (both default to your main API values for a single-gateway setup). See MCP server for the client configuration.

The tools#

Tool	What it does
`list_marketplace_apps`	List every connector (10 billing + 30 integrations).
`list_marketplace_connections`	List an app's connected providers and their status.
`get_marketplace_status`	Full status of one connection (lifecycle, mappings, recent events, webhook URL).
`connect_marketplace_app`	Connect a provider; billing returns the webhook URL to configure.
`map_marketplace_catalog`	Map provider products/prices to CashSDK products + entitlements.
`validate_marketplace_connection`	Check the configuration is complete.
`activate_marketplace_connection`	Go live, so events flow into the ledger or start delivering.
`pause_marketplace_connection`	Pause without disconnecting.
`disconnect_marketplace_app`	Turn off and wipe credentials.
`test_marketplace_dispatch`	Send a test event to active integrations.

Connect a billing backend, end to end#

Ask your agent something like "Connect Stripe and map my Pro price to the pro entitlement." Under the hood it runs:

text

connect_marketplace_app(
  provider="stripe",
  credential="rk_live_…",
  signingSecret="whsec_…",
  environment="production"
)
# → returns webhookUrl to paste into Stripe → Developers → Webhooks

map_marketplace_catalog(
  provider="stripe",
  mappings=[{ externalId: "price_123", productIdentifier: "pro_monthly", entitlement: "pro" }]
)

validate_marketplace_connection(provider="stripe")
activate_marketplace_connection(provider="stripe")

From there, every Stripe payment, renewal, and refund is verified and reconciled into your unified ledger automatically.

Connect an integration, end to end#

"Send my revenue events to Slack."

text

connect_marketplace_app(provider="slack", config={ url: "https://hooks.slack.com/services/…" })
activate_marketplace_connection(provider="slack")
test_marketplace_dispatch(type="purchase.completed", data={ userId: "u_812", productIdentifier: "pro_monthly", priceMinor: 999, currency: "usd" })

Example prompts#

"What billing backends can I connect?" → list_marketplace_apps
"Connect Paddle in sandbox and give me the webhook URL." → connect_marketplace_app
"Map Paddle price pri_123 to pro." → map_marketplace_catalog
"Is my Stripe connection healthy?" → get_marketplace_status
"Send a test purchase to my integrations." → test_marketplace_dispatch

Next steps#

MCP server

Install and configure the server.

Connector lifecycle

What each tool triggers under the hood.

Marketplace

The full connector directory.