Troubleshooting
Use this checklist when something goes wrong while connecting to or using the Xweather MCP Server.
Authentication failures
| Symptom | Likely cause | Fix |
|---|---|---|
401 Unauthorized | Missing/blank API key or copied without the underscore. | Reissue the key from the dashboard and reconnect the agent. |
403 Forbidden | Account lacks MCP scope or app disabled. | Confirm subscription level, re-enable the app, or contact support. |
Rate limiting
| Status | Description | Mitigation |
|---|---|---|
429 Too Many Requests | Burst of concurrent tool calls exceeded plan allowance. | Add exponential backoff, queue requests, or request a higher tier. |
Tool availability
- “No tools available” error: Check for conflicting filters. Remove
exclude_tags/include_toolsthat hide everything, or confirm the agent’sallowed_toolslist is not empty. - Grey connector icon: The client cannot reach the MCP endpoint. Verify the URL, network VPN rules, and that your machine trusts Xweather certificates.
Response quality
- Tighten prompts to specify timeframe, units, or required outputs (table, chart description, warning level).
- Log tool inputs/outputs and share examples with the docs team if the model misuses parameters.