Lucy · Claude Code plugin
Lucy for Claude Code
Search U.S. SEC filings without leaving Claude Code. Install the plugin, log in once with your Lucy account, and ask about any company in plain language. Claude answers from the filing passages Lucy returns.
Searches need a Lucy account approved for MCP access. How to request access.
01 · Install
Add the marketplace, then install Lucy.
Requires Claude Code 2.1.231 or newer. Check your version with claude --version.
Install from your terminal
CLIAdd the Lucy marketplace and install the plugin:
claude plugin marketplace add ezardev-team/lucy-claude-plugins claude plugin install lucy@lucydata- If Claude Code was already open, run
/reload-pluginsor start a new session so the plugin loads.
02 · Log in
Log in once with your Lucy account.
The login lasts 30 days. There is no client secret to copy or store.
Authenticate in Claude Code
/mcp- In Claude Code, open
/mcp. - Select
plugin:lucy:lucy-ragand choose Authenticate. - Log in with your Lucy account in the browser window that opens.
- When the browser shows Authentication successful, return to Claude Code.
Prefer to be guided?
setup skillSay “Connect me to Lucy” or run /lucy:lucy-mcp-setup. The setup skill walks you through the same steps.
03 · Ask
Name the company. Ask in plain language.
Mention the company and the filing or period you care about. Claude calls Lucy and answers from the passages it returns.
| Example question | Filing |
|---|---|
| Summarize the main risk factors in NVIDIA's latest 10-K. | 10-K · Item 1A |
| What did Apple say about AI in its most recent 10-Q? | 10-Q |
| Compare Microsoft's and Alphabet's cloud revenue disclosures. | 10-K |
- Name the company and the filing or period.
- Follow-up questions keep the same context.
- Complex questions can take 30–120 seconds.
- If Lucy isn't used automatically, say “Search with Lucy for …”.
- Claude answers from the filing passages Lucy returns and keeps original filing text separate from derived analysis.
- Claude does not give investment advice.
04 · The setup skill
Something looks wrong? Run the setup skill.
/lucy:lucy-mcp-setup checks the connection, walks you through login, and verifies that Lucy works. Run it anytime.
/lucy:lucy-mcp-setup05 · Access
Searches need an approved account.
Lucy for Claude Code requires a Lucy account approved for MCP access. To request access, email help@lucydata.ai with your account email. Without approval, login works but searches return 401.
06 · Troubleshooting
Common problems and fixes.
| Symptom | Fix |
|---|---|
plugin:lucy:lucy-rag is not listed in /mcp | Run /reload-plugins or start a new session. |
redirect_mismatch on the login page | Update Claude Code to 2.1.231 or newer. |
| Login never returns from the browser | Another process is using port 8088. Find it with lsof -nP -iTCP:8088 -sTCP:LISTEN. |
| Logged in, but tool calls return 401 | Your account isn't approved yet. Email help@lucydata.ai. |
| Lucy tools are listed twice | Remove an older manual registration: claude mcp remove lucy-rag -s user |
07 · Update or uninstall
Keep the plugin current.
Update
CLIclaude plugin marketplace update lucydata
claude plugin update lucy@lucydataUninstall
CLIclaude plugin uninstall lucy@lucydata08 · More
Using Claude Desktop or claude.ai?
Use the Lucy SEC filings search connector instead of the plugin. The plugin's source is on GitHub.