Search SEC filings in Claude Code with the Lucy plugin
Lucy, a search service for U.S. SEC filings, now works inside Claude Code. Install the lucy plugin with two terminal commands, log in once with a Lucy account approved for MCP access, and ask Claude about U.S. SEC filings such as 10-K, 10-Q, 8-K and 20-F in plain language. Claude answers from the filing passages that Lucy returns.
What the Lucy plugin for Claude Code does
The lucy plugin connects Claude Code to Lucy's SEC filings search, an MCP (Model Context Protocol) server. When a question mentions a company and a filing, Claude calls Lucy, Lucy returns the matching passages from the filings, and Claude writes the answer from those passages. The plugin also installs a setup skill that checks the connection and walks you through login.
Lucy for Claude Code at a glance, as of November 16, 2026:
| Item | Details |
|---|---|
| Filing types | 10-K, 10-Q, 8-K, 20-F, 40-F, 6-K, DEF 14A, S-1, S-3 and their amendments |
| Coverage | Filings from 2016 onward, where indexed |
| Sign-in | Log in once in the browser; the login lasts 30 days. There is no client secret to manage. |
| Requirements | Claude Code 2.1.231 or newer, and a Lucy account approved for MCP access |
How to install the Lucy plugin in Claude Code
Check your version with claude --version; the plugin needs Claude Code 2.1.231 or newer. Then add the Lucy marketplace and install the plugin from your terminal:
claude plugin marketplace add ezardev-team/lucy-claude-plugins
claude plugin install lucy@lucydataIf Claude Code was already open, run /reload-plugins or start a new session so the plugin loads.
How to log in to Lucy from Claude Code
- 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.
To be guided through the same steps, say "Connect me to Lucy" or run /lucy:lucy-mcp-setup. The Lucy login lasts 30 days.
What to ask Lucy in Claude Code
Name the company and the filing or period you care about. Claude then calls Lucy and answers from the passages it returns.
| Example question | Filing searched |
|---|---|
| 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 |
- Follow-up questions keep the same context.
- Complex questions can take 30 to 120 seconds.
- If Claude does not use Lucy automatically, start the question with "Search with Lucy for …".
- Claude answers from the filing passages Lucy returns and does not give investment advice.
Who can use Lucy in Claude Code
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, the login succeeds but Lucy searches return a 401 error.
Troubleshooting the Lucy plugin
| 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 | The Lucy account is not approved for MCP access yet. Email help@lucydata.ai. |
| Lucy tools are listed twice | Remove an older manual registration with claude mcp remove lucy-rag -s user. |
How to update or uninstall the Lucy plugin
claude plugin marketplace update lucydata
claude plugin update lucy@lucydataTo remove it, run claude plugin uninstall lucy@lucydata.
Using Claude Desktop or claude.ai instead
The plugin is for Claude Code. In Claude Desktop or claude.ai, use the Lucy SEC filings search connector in the Claude directory. The Lucy plugin source is on GitHub, and the full setup guide is on the Lucy for Claude Code page. To learn how Lucy retrieves filing passages, see Lucy RAG for SEC filings and the LucyRAG benchmark on SEC filings.