> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapping.travel/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common MCP connection errors and fixes.

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Your `X-API-Key` is missing or invalid. Regenerate the key from **Developers → MCP** in [app.mapping.travel](https://app.mapping.travel).
  </Accordion>

  <Accordion title="403 MCP_TIER_REQUIRED">
    Your organization's tier dropped to BASIC. Upgrade at [/billing](https://app.mapping.travel/billing) to restore access.
  </Accordion>

  <Accordion title="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).
  </Accordion>

  <Accordion title="Server unreachable">
    The hosted MCP server may be in maintenance. Contact support.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>