​

Troubleshooting

​

MCP server won’t start / tools missing

• Confirm args use nebulamcp-stdio, not @nebula/mcp.
• Set NEBULA_TOKEN and NEBULA_HUB to the matching ledger host.
• Restart Claude Desktop or toggle the server in Cursor.

​

Unauthorized / redirect errors

Tokens minted on testnet fail against mainnet (and the reverse). Apex /mcp redirects can drop Bearer headers. Use testnet. or mainnet. hosts only.

​

Policy rejected

Check get_policy_status: caps, pause, allow/deny. Raise caps or unpause in the dashboard. See Set policy limits.

​

confirmation_required forever

Approve or reject at /approve/:id. await_confirmation waits at most 25 seconds per call. Re-call with the same id until decided or expired.

​

Funding / USDC

On testnet, request_funding returns Friendbot instructions. Open a USDC trustline before x402, MPP, or swaps into USDC.

​

Treasury looks stuck

Call get_treasury_status. Threshold and manual Blend moves are dashboard-only. Agents can try optimize_treasury.