Skip to main content
Docs

Documentation

Everything you need to integrate CompanyLens into your application or AI agent.

MCP troubleshooting

Common problems and fixes for the CompanyLens MCP server. If you haven't set up the server yet, start with the setup guide.

Tools don't appear after setup

Fully quit and reopen your AI tool — a reload or restart of the chat is not always enough. For Claude Desktop, open the config file and confirm it is valid JSON: a trailing comma or missing brace will silently prevent the server from loading. For Cursor, check Settings → Tools & MCP to confirm the server shows a green status dot.

OAuth loop — the sign-in window keeps reopening

This usually means the OAuth token wasn't persisted after sign-in. Confirm that pop-ups are not blocked in your browser for companylens.io. If the loop continues, remove the connector from your AI tool and re-add it from scratch — this forces a clean token exchange.

Authentication keeps failing after signing in

Sign out of companylens.io and sign back in, then retry the OAuth flow in your AI tool. If your account was created recently, allow a few minutes for provisioning. Contact [email protected] if the problem persists — include the email address on your account.

Tool returns no results for a company

Not all data sections are available in every jurisdiction. Before calling a section tool, call get_company and inspect the supportedSectionsfield — it lists exactly what's available for that entity. The jurisdictions & coverage page shows which data types are available per registry.

Search returns too many unrelated companies

Include the country or jurisdiction in your prompt — e.g. “UK company” or “Irish registry”. You can also ask the agent to use searchMode: 'prefix' or searchMode: 'exact' for more precise matching, which is especially useful for due diligence where you need an exact name match.

Rate limit — quota exceeded

Ask your agent to call get_usage to see your remaining quota and when it resets. The free tier allows 50 MCP queries per month. Upgrade your plan →

Still stuck?

Email [email protected] with a description of the problem and the AI tool you're using. If you can reproduce it, include the exact prompt and the tool response.