Install troubleshooting

Top install issues

1. Issue 01

   Claude Code doesn't show Foundry tools

   Diagnosis

   JSON syntax error in ~/.mcp.json — missing brace or comma.

   Fix

   Validate the file with a JSON linter (or paste it into jsonlint.com), then restart Claude Code.

2. Issue 02

   Terminal says: command not found: npx

   Diagnosis

   Node.js isn't installed (or it's behind PATH).

   Fix

   Install Node.js 20 LTS or 22 from nodejs.org, then re-open the terminal.

3. Issue 03

   `unauthorized` error from `npx @dig-tools/mcp doctor`

   Diagnosis

   License key is wrong, was revoked, or was rotated.

   Fix

   Re-paste the key from your install email, or sign in to the dashboard and generate a new one.

4. Issue 04

   `rate_limited` immediately after installing

   Diagnosis

   Free Optimizer is capped at 10,000 tool calls / month.

   Fix

   Wait until the next calendar month (UTC), upgrade to Starter, or buy an à la carte pack.

5. Issue 05

   `pack_locked` on a tool you expected

   Diagnosis

   The tool belongs to a pack you don't have entitled at your tier.

   Fix

   Upgrade your tier or attach the pack à la carte from the pricing page.

6. Issue 06

   Stub crashes on startup

   Diagnosis

   Node version is below 20 (Foundry doesn't support older Node).

   Fix

   Upgrade Node to 20 LTS or 22, then restart Claude Code.