Troubleshooting
Common failure modes when first connecting to the MCP server.
| Symptom | Likely cause | Fix |
|---|---|---|
hybrid_search_reranked returns nothing | Portal not listed in get_filters("semantic_portals"). | Call get_filters("semantic_portals") first. If the portal is absent, switch to keyword_search. |
| Date filter rejected | Only one of from_date or until_date supplied. | Pass both as YYYY-MM-DD. |
| OAuth never completes | Pop-ups blocked or third-party cookies disabled. | Allow pop-ups and cookies for mcp.moonlit.ai and claude.ai, then retry. |
| API key rejected at consent | Key expired, rotated, or wrong tenant. | Send an email to ralph@moonlit.ai if your key doesn't work. |
| 401 on a tool call mid-session | Refresh token expired. | Disconnect and reconnect the connector. |
hybrid_search_reranked is slow | By design. The reranker runs on every query. | Switch to keyword_search if latency matters more than precision. |
convert_to_celex returns nothing | Wrong document type (directive vs regulation) or wrong year of adoption. | Confirm in EUR-Lex first. Working examples: GDPR (regulation, 2016, 679), AI Act (regulation, 2024, 1689). |
reference_search returns docs from unexpected portals | Filter pollution. portals controls jurisdiction; sources controls publishing source. | Pass sources= and portals= explicitly. Discover IDs via get_filters. |
Still stuck?
- Email support@moonlit.ai.
- Include: tool name, full arguments object, UTC timestamp, identifier of any wonky document, and your account email.
For privacy questions see the FAQ or email privacy@moonlit.ai.