Troubleshooting
August 5, 2026 ยท View on GitHub
The client cannot connect
- Confirm the endpoint is exactly
https://mcp.vpn.fail/mcp. - Ensure the client supports remote Streamable HTTP, not only local stdio servers.
- Use
service_statusafter connection to confirm the tool session works.
A scrape fails
- Verify the URL is public and starts with
http://orhttps://. - Try
https://example.comto separate a client configuration issue from a target-specific issue. - Try a different
outputvalue:markdown,text, orhtml. - Check
usagefor a quota or concurrency limit.
Content is incomplete or unsuitable
- The public beta has a 2 MiB response cap.
- JavaScript browser rendering is not currently provided.
- Websites can redirect, reject requests, or return content that cannot be converted cleanly.
For reproducible faults, open an issue without including sensitive URLs, credentials, or personal data.