Troubleshooting
"Token missing required ability …"
The token doesn't carry the ability the tool needs. Mint a new one at API tokens with the right abilities.
401 Unauthorized
Token is wrong, expired, or revoked. Mint a fresh one and update your client config.
404 on a form_id you own
Tokens are team-scoped. The form belongs to a different team. Switch your active team in the dashboard, mint a token in that team, and try again.
423 / "AI Insights are not available on your current plan"
The team's plan doesn't include AI features. Upgrade in Billing or skip the AI tools.
"Insights regeneration is already running"
regenerate_ai_insights is locked for 5 minutes after a trigger. Wait, then retry.
Agent doesn't see survey / funnel / webhook / AI tools
On the Free plan, those tools are filtered out of tools/list by design. Upgrade to Pro or higher, or ask the agent to use forms, submissions, links, and automations instead. If you're already on Pro or higher, confirm the token includes the right abilities (for example surveys:read) and that you're on the team you minted the token in.
plan_required or "requires a paid plan"
The token has the ability, but the team's subscription does not include that product (surveys, funnels, webhooks, or AI). Upgrade in Billing or use a tool your plan includes.
Agent doesn't see the tools after editing config
Quit the client fully (don't just close the window) and relaunch. MCP server lists are cached at startup. Zed is the exception - it hot-reloads.
Webhook secret returned null
Some clients hide non-data fields. Recreate the webhook to get a fresh secret, or call the REST API directly.