install-paydirt

Add Paydirt to an iOS app

The human signs in once in the browser. Everything else happens here, in chat. Never ask the human for API keys, tokens, or credentials. You write the SDK key into the project yourself.

1. Inspect, then propose in ONE message

Inspect the project before calling any Paydirt tool: the app target, bundle ID, dependency manager, app entry point, subscription source of truth (RevenueCat, StoreKit, Superwall paywalls, custom), product IDs, and the file where the real cancel flow lives. Note every existing feedback screen and purchase flow; you will preserve all of them.

Then send one message and wait for the reply. Create nothing before the human confirms.

With subscriptions and a cancel flow:

I found your StoreKit subscriptions and the real cancel flow in Settings/ManageSubscriptionView.swift. I recommend three starting forms: Subscription Cancellation, Trial Cancellation, and Suggest a Feature (in Settings). Responses go to Slack and here in Claude Code. Reply "yes" to set this up, or tell me Slack only, here only, or which form to drop. Nothing is created until you confirm.

Without subscriptions or a cancel flow:

I didn't find subscriptions or a cancel flow, so cancellation feedback has nothing to trigger it yet. I recommend Suggest a Feature (in Settings). Responses go to Slack and here in Claude Code. Reply "yes" to set this up, or tell me Slack only or here only. Nothing is created until you confirm.

Use the real provider, file, and agent name. A plain "yes" accepts the recommended forms and the destinations ["slack", "claude-code"] (use "codex" in Codex). The human may pick Slack only, here only, or drop any form. paydirt_begin_setup without form_plan_confirmed returns this message for you if you need it.

2. Create the app and forms, save delivery, start Slack

Right after the human confirms:

1. Call paydirt_begin_setup with form_plan_confirmed: true, the confirmed use_cases, destinations, app_name, bundle_id, subscription_provider, subscription_product_ids, feature_placement, and cancel_flow_file.
   • Hosted connection (https://mcp.paydirt.ai/mcp): this creates or reuses the app and forms right away and returns the installation contract.
   • Local stdio server: it returns authorization_url. Give it to the human; that page only signs in. Then call paydirt_finish_setup with finish_arguments. Do not poll or sleep while they sign in.
2. destinations saves delivery. If you did not pass them, call paydirt_set_delivery. Setup returns delivery_selection_required, never a silent default, when no destination is saved. In that case ask its question exactly.
3. If Slack was chosen and the contract says it is not connected, call paydirt_connect_slack now and share the link: "While I build, connect Slack: ". Do not wait for Slack.