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_…).
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):
{
"mcpServers": {
"cashsdk": {
"command": "npx",
"args": ["-y", "@cashsdk/mcp"],
"env": {
"CASHSDK_TOKEN": "csk_sk_...",
"CASHSDK_APP": "app_...",
"CASHSDK_API_URL": "https://api.cashsdk.com"
}
}
}
}
Enable and verify#
Go to Cursor Settings → MCP (or Tools & Integrations). Cursor
detects the cashsdk server from your mcp.json.
Enable the cashsdk server. Cursor spawns npx -y @cashsdk/mcp over stdio.
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:
{
"mcpServers": {
"cashsdk-docs": {
"url": "https://docs.cashsdk.com/mcp"
}
}
}
You can also add a .cursor/rules file pointing Cursor at
https://docs.cashsdk.com/llms-full.txt so the model always has the full
CashSDK reference in context. See llms.txt.
Example prompts#
Open the Cursor chat in Agent mode and try:
- "Using CashSDK, create a monthly Pro subscription with a
proentitlement." - "Generate an onboarding paywall from a template and add a placement for it."
- "Register a webhook at
https://api.myapp.com/hooks/cashsdkand send a test event." - "Tail the recent CashSDK events for this app."
- "What's still outstanding on my CashSDK setup checklist?"