Claude Code

Connect CashSDK to Claude Code with a single command or a committed .mcp.json.

Add the CashSDK MCP server to Claude Code and ask it to set up your catalog, generate paywalls, or wire up webhooks, right from your terminal.

Add the server#

The CashSDK MCP server is hosted, so one command connects it. Create an MCP token in Settings → MCP; limit it to one app or read-only access when appropriate:

bash

claude mcp add cashsdk \
  --transport http \
  --url https://mcp.cashsdk.com/mcp \
  --header "Authorization: Bearer csk_mcp_..."

An app-limited MCP token names the app it belongs to, so tools work without an app id.

Project `.mcp.json`#

Prefer to check the configuration into the repo so teammates get it automatically? Add an .mcp.json at the project root:

json

{
  "mcpServers": {
    "cashsdk": {
      "url": "https://mcp.cashsdk.com/mcp",
      "headers": {
        "Authorization": "Bearer csk_mcp_..."
      }
    }
  }
}

CashSDK ships as a shareable setup: commit an .mcp.json to your repo and everyone who opens it in Claude Code gets the CashSDK tools with no manual configuration. Claude Code prompts each user to approve project-scoped servers the first time.

Don't commit a real token. Use a placeholder in the checked-in .mcp.json and have each developer supply their own, or reference an environment variable. Prefer an MCP token (csk_mcp_…) from Settings › MCP. The csk_st_… setup token in the integration prompt expires in 24 hours, so a config file holding one stops working overnight.

Give it the docs too#

Point Claude Code at the machine-readable docs index so it has the full CashSDK reference in context, no token required:

https://docs.cashsdk.com/llms.txt        # index
https://docs.cashsdk.com/llms-full.txt   # every page inlined

Verify#

Run claude mcp list to confirm the server is connected, or start a Claude Code session and ask "What CashSDK tools do you have?". You should see tools like get_setup_checklist, create_product, and generate_paywall.

Example prompts#

"Set up a monthly Pro subscription and generate a paywall for it."
"Create a pro entitlement, then grant it to customer u_812 for testing."
"Register a webhook at https://api.myapp.com/hooks/cashsdk and send a test event."
"Sync my catalog from the App Store and show what changed."
"Tail the last few purchase events for this app."

Next steps#

MCP server reference

Every tool and environment variable.

Connect Cursor

Same server, in the editor.

Connect Codex

Configure the OpenAI Codex CLI.

llms.txt

Feed the full docs to any model.