Lookupd MCP Server

lookupd

The registry agents call to find the right MCP server, skill or agent for a task. Free to look up. Neutral: lookupd never hosts or proxies tool calls, and rank is never for sale. Rankings are provisional until real outcome evidence exists.

This repository holds everything an agent installs:

• lookupd on npm: the CLI and the npx lookupd mcp stdio bridge to the lookupd API
• skills/find-capability: the skill that teaches an agent the find → approve → install → report loop
• a Claude Code plugin + marketplace (this repo is both)

The API, crawler and ranking live in a private repository. Data: Official MCP Registry (CC0), mirrored and enriched by lookupd; lookupd is not affiliated with the MCP project.

Install

Claude Code (plugin: skill + MCP tools):

/plugin marketplace add lookupd/lookupd
/plugin install lookupd@lookupd

Any agent that reads skills (skills.sh):

npx skills add lookupd/lookupd

MCP only, any client that launches stdio servers:

claude mcp add lookupd -- npx -y lookupd@latest mcp

.vscode/mcp.json:

{ "servers": { "lookupd": { "command": "npx", "args": ["-y", "lookupd@latest", "mcp"] } } }

.cursor/mcp.json / Claude Desktop:

{ "mcpServers": { "lookupd": { "command": "npx", "args": ["-y", "lookupd@latest", "mcp"] } } }

Remote endpoint, for clients that connect to streamable HTTP directly: https://api.lookupd.com/mcp.

Tools

CLI

npx lookupd find "read Linear issues" --runtime claude-code
npx lookupd find "pdf extraction" --json
npx lookupd telemetry on|off|status
npx lookupd login --key lk_...        # optional API key
npx lookupd mcp                       # stdio bridge (what the plugin runs)

Environment: LOOKUPD_API_URL (default https://api.lookupd.com), XDG_CONFIG_HOME. Config lives at ~/.config/lookupd/config.json.

Telemetry

Off by default. When you run lookupd telemetry on, the agent can call report_outcome after using a server it found through lookupd. A report contains only: the entry name, success, a latency bucket, your runtime, a capability tag from a fixed list, and an error class. Never prompts, task text, file paths or output. Lookups themselves are free and unauthenticated; the search phrase is stored truncated to 160 characters as anonymous demand data. Policy: https://lookupd.com/telemetry

Develop

pnpm install
pnpm test        # vitest: bridge, CLI, API client, config, manifests
pnpm build       # tsup → dist/cli.js
claude plugin validate .

Local end-to-end against a dev API: LOOKUPD_API_URL=http://localhost:3000 npx lookupd find "linear", and in Claude Code /plugin marketplace add /path/to/this/repo.

License

MIT. See LICENSE.