Cursor

Connect CashSDK to Cursor so you can manage your account from the editor.

Add the CashSDK MCP server to Cursor and your agent can operate your workspace — model catalog, generate paywalls, register webhooks — without leaving the editor.

Add the server#

Create .cursor/mcp.json in your project root (or edit the global ~/.cursor/mcp.json to make it available everywhere):

json
{
  "mcpServers": {
    "cashsdk": {
      "command": "npx",
      "args": ["-y", "@cashsdk/mcp"],
      "env": {
        "CASHSDK_TOKEN": "csk_sk_...",
        "CASHSDK_APP": "app_...",
        "CASHSDK_API_URL": "https://api.cashsdk.com"
      }
    }
  }
}

A project .cursor/mcp.json may be committed to your repo — do not put a real CASHSDK_TOKEN in a file you commit. Use a placeholder and have each developer fill in their own, or keep the config in the global ~/.cursor/mcp.json instead. Prefer a scoped setup token (csk_st_…).

Enable and verify#

1
Open MCP settings

Go to Cursor Settings → MCP (or Tools & Integrations). Cursor detects the cashsdk server from your mcp.json.

2
Toggle it on

Enable the cashsdk server. Cursor spawns npx -y @cashsdk/mcp over stdio.

3
Confirm the tools loaded

The server should show a green status and a list of tools like get_setup_checklist, create_product, and generate_paywall. If it shows an error, check CASHSDK_TOKEN and that CASHSDK_API_URL points at a reachable API.

Add the docs MCP (optional)#

To let Cursor search the CashSDK documentation as well, add the hosted docs server. It's read-only and needs no token:

json
{
  "mcpServers": {
    "cashsdk-docs": {
      "url": "https://docs.cashsdk.com/mcp"
    }
  }
}

Example prompts#

Open the Cursor chat in Agent mode and try:

  • "Using CashSDK, create a monthly Pro subscription with a pro entitlement."
  • "Generate an onboarding paywall from a template and add a placement for it."
  • "Register a webhook at https://api.myapp.com/hooks/cashsdk and send a test event."
  • "Tail the recent CashSDK events for this app."
  • "What's still outstanding on my CashSDK setup checklist?"

Next steps#