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

# Troubleshooting

> Common issues and how to resolve them.

## API & Execution

<AccordionGroup>
  <Accordion title="429 Too Many Requests">
    You've exceeded your plan's TPS limit. Check your current plan under **Management → Billing** and consider upgrading to a higher tier. Free = 10 TPS, Growth = 100 TPS, Pro = 500 TPS, Enterprise = Custom.
  </Accordion>

  <Accordion title="ENTITY_NOT_FOUND error">
    The resource ID doesn't exist or belongs to a different tenant. Verify the ID by running the corresponding `list` command. UUIDs are case-sensitive — copy them exactly from API responses.
  </Accordion>

  <Accordion title="CANNOT_MODIFY error">
    You're trying to edit a non-DRAFT version. Published versions are permanently locked. Clone the version to create a new DRAFT: use `lexq versions clone --group-id <gid> --id <vid>`.
  </Accordion>

  <Accordion title="EMPTY_RULES error on publish">
    A version must have at least one rule before publishing. Add rules with `lexq rules create`, then try publishing again.
  </Accordion>

  <Accordion title="Rules don't match expected inputs">
    Run `lexq analytics requirements` to see which facts the version expects. Then run a Dry Run with `--debug` to inspect execution traces and decision traces for each rule.
  </Accordion>

  <Accordion title="POLICY_GROUP_DISABLED error">
    The policy group is in `DISABLED` status. Re-enable it in the Console under group settings, or via `lexq groups update --id <gid> --json '{"status": "ACTIVE"}'`.
  </Accordion>
</AccordionGroup>

## CLI

<AccordionGroup>
  <Accordion title="'lexq: command not found'">
    The CLI is not installed globally. Run `npm install -g @lexq/cli` or use `npx @lexq/cli` instead.
  </Accordion>

  <Accordion title="'API key not found' when running commands">
    Run `lexq auth login` to store your API key. The key is persisted at `~/.lexq/config.json`.
  </Accordion>
</AccordionGroup>

## MCP Server — Cloud (Claude.ai)

<AccordionGroup>
  <Accordion title="'Authorization with the MCP server failed'">
    Remove the LexQ connector in **Settings → Connectors**, then re-add `https://mcp.lexq.io`. Ensure you complete both the login step and the API Key selection/generation step before clicking Authorize.
  </Accordion>

  <Accordion title="'Failed to create API key' during authorization">
    Your account may have reached the API Key limit. Go to **Console → Management → API Keys** and delete unused keys, then try again.
  </Accordion>

  <Accordion title="Tools appear but calls return errors">
    Your API Key may have been revoked or the account deactivated. Remove the connector and re-authorize with a valid key.
  </Accordion>
</AccordionGroup>

## MCP Server — Local (stdio)

<AccordionGroup>
  <Accordion title="MCP server starts but no tools appear">
    Restart your AI client (Claude Desktop, VS Code, etc.) after adding the MCP configuration. Some clients cache tool lists on startup.
  </Accordion>

  <Accordion title="'npx: command not found'">
    Node.js 18+ is required. Run `node --version` to verify. If not installed, download from [nodejs.org](https://nodejs.org).
  </Accordion>

  <Accordion title="Connection timeout or transport error">
    The local MCP server uses **stdio transport** — it reads from stdin and writes to stdout. It does not open network ports. If your AI client only supports HTTP/SSE transport, use the [Cloud method](/cli/mcp-server#cloud--claudeai-custom-integration) instead.
  </Accordion>
</AccordionGroup>

## Still stuck?

Visit [Support](/help/support) to reach the LexQ team directly.