Skip to main content

​
Common Errors

Your API key is missing from the MCP configuration. Make sure it is set in the env block of your MCP config. Get your API key at app.leeroopedia.com.
Your API key is not valid. This can happen if the key was copied incorrectly or was revoked.Fix: Go to app.leeroopedia.com, re-copy your key, and update your MCP config.
Your account has run out of search credits.Fix: Purchase more credits at app.leeroopedia.com.
You have made too many requests in a short period.Fix: Wait for the retry period indicated in the error message.
The search task did not complete within the polling window (default: 300 seconds).Fix: Try a more specific query, or increase LEEROOPEDIA_POLL_MAX_WAIT.

​
Connection Issues

Your IDE (Cursor, Claude Desktop, etc.) can’t find uvx because GUI apps don’t inherit your shell’s PATH.Fix:
  1. Open your terminal and run which uvx (or where uvx on Windows) to get the full path.
  2. Replace "uvx" with the full path in your MCP config:
"command": "/home/username/.local/bin/uvx"
Common locations:
  • Linux: ~/.local/bin/uvx
  • macOS (curl install): ~/.local/bin/uvx
  • macOS (Homebrew): /opt/homebrew/bin/uvx
  • Windows: Run where uvx to find the path
If uvx is not installed at all, install uv first: docs.astral.sh/uv.
If Claude Code or Cursor cannot connect to the MCP server, check that uvx is installed, test the server directly with LEEROOPEDIA_API_KEY set, and run claude mcp list to verify connectivity.
In Claude Code non-interactive mode, MCP tools need explicit permission. Use —allowedTools or —dangerously-skip-permissions. In interactive mode, a prompt appears automatically.

​
Getting Help