Troubleshooting the MCP server

{ "error": { "code": "not_found", "message": "No form with that id on your account.", "hint": "Call list_forms to see your form ids." } }
Symptom	Likely cause	Fix
Client can’t connect / connection refused	Wrong endpoint host	The endpoint is `https://api.formpaste.com/mcp` (note `api.`, not `app.`).
Tool call returns `unauthorized`	Missing, mistyped, or revoked token	Re-mint a token under Settings → API & MCP and update your client config. The token is shown once.
A read tool returns `forbidden`	A setup-scoped token called `list_submissions`	Setup tokens cannot read submissions. Use a full-access token, or mint one. See API tokens.
Tool call returns `not_found`	Wrong `formId`, or a form owned by a different account	Call `list_forms` to get valid ids for the token’s account.
`formpaste` not listed after install	Client not restarted, or stale `mcp-remote`	Restart the client. If it persists, clear the `mcp-remote` cache (`npx clear-npx-cache`) and reconnect.
Only three tools show	An old cached connection	Reconnect - the current server exposes six tools (`create_form`, `get_snippet`, `list_forms`, `get_form`, `send_test_submission`, `list_submissions`).