Start With the Echo Test
Ask your AI tool, "Run the 4M echo tool." If echo works but a question about an area fails, your connection is fine and the issue is with the request or your account setup.
Common Error Messages
Message | What to do |
401 or "no key" | Check that your key is in a header named x-account-key, with only the key as the value. If you set the key as an environment variable, restart your AI tool. |
INVALID_GEOMETRY | The area shape is broken. Ask your AI tool to rebuild it. |
VERTEX_LIMIT_EXCEEDED | The shape has more than 1,000 points. Simplify it, especially buffers exported from GIS or CAD. |
AREA_LIMIT_EXCEEDED | The area is larger than your organization's limit. The message shows both sizes. Split it into smaller areas. |
MULTI_STATE_AREA | The area crosses a state line. Ask about each state separately. |
UNSUPPORTED_REGION | 4M doesn't have coverage there yet. |
ORG_NOT_CONFIGURED | Your account isn't set up for this type of area. Contact your account manager. |
UPSTREAM_UNAVAILABLE | A temporary issue on our side. Try again in a few minutes. |
Other Issues
Symptom | Fix |
Empty results for an area you know has utilities | The location may have been read backwards. Ask your AI tool to show the area on a map before querying. |
Can't connect from your office network | Your network may block the 4M server. Ask your IT team to allow mcp.4map.4manalytics.com. |
Lost your key | Create a new one in WFS & API Keys → MCP. |
Don't see WFS & API Keys | MCP keys are created by Admins. Ask your 4M Admin, or reach out to your account manager. |
Still need help? Contact our support team and include the error message you received.
Need access to the 4M Data MCP? Reach out to your account manager to get your organization set up.