Cascades Docs
Sign in to run requests with your own sandbox key. Sign in
View as Markdown Open in Claude Open in ChatGPT Add MCP server

Install

Add Cascades to Claude Code

  1. Run the command below from your project. npx fetches the server on first use; nothing to install.
  2. Restart Claude Code (or run /mcp) and confirm cascades shows as connected.
  3. Ask: List my cascades and run the first one for a sandbox test case.
Your docs key stops working after 1 hour
When you are signed in, the commands and configs on this page fill in your docs key, which expires 1 hour after it is created or when you sign out. After that, the Cascades tools in Claude Code stop working. For a key that lasts 90 days, create one on the API keys page. Then replace the CASCADES_API_KEY value of the cascades server in Claude Code's MCP config with the new key.
Terminal
claude mcp add cascades \
  -e CASCADES_API_KEY={{API_KEY}} \
  -e CASCADES_PROD_BASE_URL=https://cascades.crscreditapi.com \
  -- npx -y @crscreditapi/cascades-mcp-server
.mcp.json
{
  "mcpServers": {
    "cascades": {
      "command": "npx",
      "args": [
        "-y",
        "@crscreditapi/cascades-mcp-server"
      ],
      "env": {
        "CASCADES_API_KEY": "{{API_KEY}}",
        "CASCADES_PROD_BASE_URL": "https://cascades.crscreditapi.com"
      }
    }
  }
}

Notes

  • CASCADES_PROD_BASE_URL is the host without /api/v1 (https://cascades.crscreditapi.com); the server adds the prefix.
  • The key needs workflows:read, workflows:write, executions:read, executions:write. A key missing a scope gets 403 insufficient_scope on the affected tool only.
  • Sandbox keys can only run in test mode: execution_mode: "live" is billable, needs a production-approved account, and is rejected for docs-issued keys.
  • Prefer the JSON? Commit .mcp.json to the repo so every collaborator gets the server; keep the key out of git by using ${CASCADES_API_KEY} and exporting it in your shell.

Test with MCP Inspector

Check the key and host before trusting the editor integration: this runs the server with the same environment and lets you call each tool from a browser UI.

Your docs key stops working after 1 hour
When you are signed in, the commands and configs on this page fill in your docs key, which expires 1 hour after it is created or when you sign out. After that, the Cascades tools in Claude Code stop working. For a key that lasts 90 days, create one on the API keys page. Then replace the CASCADES_API_KEY value of the cascades server in Claude Code's MCP config with the new key.
Terminal
CASCADES_API_KEY={{API_KEY}} CASCADES_PROD_BASE_URL=https://cascades.crscreditapi.com \
  npx @modelcontextprotocol/inspector npx -y @crscreditapi/cascades-mcp-server

What you get

Tool What it does Access REST call
cascades_create_workflow Create a new cascade (decision workflow) from a JSON definition, owned by the API key's account. write POST /workflows
cascades_delete_workflow Delete a cascade (soft-delete). destructive DELETE /workflows/{id}
cascades_generate_workflow Build a cascade from a plain-English policy description using the Cascades AI builder, then create it (by default) so it is immediately runnable with cascades_trigger_workflow. write POST /workflows/generate
cascades_get_execution Fetch a single cascade execution by id to check its status and results. read GET /executions/{id}
cascades_get_workflow Fetch one cascade by id, including its full node graph (`definition`). read GET /workflows/{id}
cascades_list_test_cases List the pre-registered sandbox test-case subjects for a cascade โ€” the synthetic applicants the CRS Testcase Service has authored for that cascade's products (e.g. specific credit-score bands). read GET /workflows/{id}/test_cases
cascades_list_workflows List the caller's saved Cascades (decision workflows) โ€” their id, code, name, use_case, trigger_type, and whether each is active. read GET /workflows
cascades_trigger_workflow Run a saved cascade for an applicant โ€” i.e. start a decision. write POST /workflows/{id}/trigger
cascades_update_workflow Update an existing cascade. write PATCH /workflows/{id}