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 fastest way is the claude mcp add command. It registers the CashSDK MCP server over stdio and passes your credentials as environment variables:

bash

claude mcp add cashsdk \
  --env CASHSDK_TOKEN=csk_sk_... \
  --env CASHSDK_APP=app_... \
  -- npx -y @cashsdk/mcp

Everything after -- is the command Claude Code runs to launch the server.

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": {
      "command": "npx",
      "args": ["-y", "@cashsdk/mcp"],
      "env": {
        "CASHSDK_TOKEN": "csk_sk_...",
        "CASHSDK_APP": "app_...",
        "CASHSDK_API_URL": "https://api.cashsdk.com"
      }
    }
  }
}

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 CASHSDK_TOKEN. Use a placeholder in the checked-in .mcp.json and have each developer supply their own secret, or reference an environment variable. Prefer a scoped setup token (csk_st_…).

Add the docs MCP#

The CashSDK documentation is also available as a hosted MCP server over HTTP. It's read-only and needs no token — great for searching guides and API details:

bash

claude mcp add --transport http cashsdk-docs https://docs.cashsdk.com/mcp

Verify#

Run claude mcp list to confirm both servers are 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