Troubleshooting

Common MCP connection errors and fixes.

401 Unauthorized

Your X-API-Key is missing or invalid. Regenerate the key from Developers → MCP in app.mapping.travel.

403 MCP_TIER_REQUIRED

Your organization’s tier dropped to BASIC. Upgrade at /billing to restore access.

403 MCP_ENDPOINT_DENIED

MCP keys are restricted to a curated set of endpoints. Use a standard API key for endpoints outside the allow-list (billing, legal, supplier writes, export webhook config).

Server unreachable

The hosted MCP server may be in maintenance. Contact support.

Schema mismatch or unknown tool

Your client may be caching an old tool list. Reconnect and have the agent call get_mcp_schemas to refresh.