Lets an AI client search and look up 17,000+ MCP servers in the public agentage directory to find tools and install commands.
Also known as agentage/find-mcp, @agentage/find-mcp
- Stars
- 6
- Tools
- 3
- Downloads, 30 days
- 1,339
- Latest version
- —
- Last commit
- Nov 14, 2026
- License
- MIT
What is agentage MCP directory MCP?
agentage MCP directory lets an AI client search and look up 17,000+ MCP servers in the public agentage directory to find tools and install commands. It exposes 3 tools, such as mcp_search, mcp_get, mcp_categories.
Summary generated from the project's README
About agentage MCP directory MCP server
Locating specific tools for your AI assistant from a massive collection is what find-mcp enables. It provides an interface for AI clients to search through a public directory containing over 17,000 MCP servers. This allows users to find the exact connection they need for databases, web searches, or automation without manual searching.
Developers can integrate this into stdio-only clients like Claude Desktop, Cursor, or VS Code by adding a single npx command to their configuration. It acts as a thin proxy that forwards requests to a remote endpoint, meaning it requires no sign-up, no API keys, and no permanent local installation. The server is read-only and does not execute or change anything on your machine.
Through three specific tools, the server provides deep discovery capabilities. You can use mcp_search to find servers using keyword, category, language, or license filters. The mcp_get tool retrieves full package details and installation commands for a specific server, while mcp_categories helps you discover available filtering options.
What you can do with it
- 1Discovering database connection toolsAsk your AI to find a specific MCP server that allows it to interact with a Postgres database.
- 2Retrieving installation instructionsRequest the exact command needed to set up a Notion integration within your current environment.
- 3Exploring tool categoriesIdentify which MCP servers are currently trending or widely used for automating web browsers.
Written from the project's README. Every use case is checked against a quote from it.
How to install agentage MCP directory MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall agentage MCP directory MCP in Claude Code
$ claude mcp add find-mcp -- npx -y @agentage/find-mcpInstall agentage MCP directory MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"find-mcp": {
"command": "npx",
"args": [
"-y",
"@agentage/find-mcp"
]
}
}
}Install agentage MCP directory MCP in VS Code
.vscode/mcp.json
{
"servers": {
"find-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentage/find-mcp"
]
}
}
}Install agentage MCP directory MCP in VS Code CLI
$ code --add-mcp '{"name":"find-mcp","type":"stdio","command":"npx","args":["-y","@agentage/find-mcp"]}'Install agentage MCP directory MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"find-mcp": {
"command": "npx",
"args": [
"-y",
"@agentage/find-mcp"
]
}
}
}Install agentage MCP directory MCP in Codex
$ codex mcp add find-mcp -- npx -y @agentage/find-mcpInstall agentage MCP directory MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.find-mcp] command = "npx" args = ["-y", "@agentage/find-mcp"]
Install agentage MCP directory MCP in Gemini CLI
$ gemini mcp add -s user find-mcp npx -- -y @agentage/find-mcpInstall agentage MCP directory MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"find-mcp": {
"command": "npx",
"args": [
"-y",
"@agentage/find-mcp"
]
}
}
}agentage MCP directory MCP tools 3
Detected from the READMEmcp_searchmcp_getmcp_categories
Configuration
LIVE_SMOKE
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHub@agentage/find-mcp
Give your AI a directory of 17,000+ tools. One command connects Claude, Cursor, or VS Code to the public agentage MCP directory, and your AI finds the right tool in seconds - free, read-only, no sign-up.
What is this?
AI apps like Claude and Cursor can use outside tools - for reading databases, sending email, searching the web, and thousands of other things - through an open standard called MCP. The hard part is finding the right tool.
This package solves that: it gives your AI a searchable directory of 17,000+ of those tools, so you can simply ask for what you need and let the AI find it. Nothing to install permanently, no account, and it can only read the directory - it never changes anything on your machine.
Prefer to look around yourself? The same directory is browsable at catalog.agentage.io/mcp.
Get started
Add this to your AI app, then ask away.
Claude Desktop / Cursor / VS Code (mcp.json)
{
"mcpServers": {
"find-mcp": {
"command": "npx",
"args": ["-y", "@agentage/find-mcp"]
}
}
}
Claude Code
claude mcp add find-mcp -- npx -y @agentage/find-mcp
Then ask your AI things like
- "Find me a tool that connects you to Postgres."
- "Is there an MCP server for Notion? How do I install it?"
- "What are the most popular tools for browser automation?"
Tools
The tool set is served by the remote directory (this proxy forwards it as-is):
| Tool | What it does |
|---|---|
mcp_search |
Find MCP servers by keyword, with category/language/license filters |
mcp_get |
Return one server's full packages, tools, and install command by slug |
mcp_categories |
List the category/language/license values you can filter on |
How it works
This is the npm client for the agentage MCP directory - a thin stdio proxy that bridges
stdio-only MCP clients to the public remote endpoint https://catalog.agentage.io/mcp.
It is intentionally tiny: it holds no tool logic. On start it connects to the remote
directory over Streamable HTTP and forwards tools/list and tools/call verbatim, so upstream
tool changes flow through without republishing this package. Forwarding is bounded by the pinned
MCP SDK schemas, so a brand-new upstream tool field may need an SDK bump here to pass through.
The directory is public and read-only - no auth, no keys, nothing installed or executed.
Remote clients don't need this package
Clients that support remote MCP servers can point straight at the Streamable HTTP endpoint:
https://catalog.agentage.io/mcp
This package exists only to bridge stdio-only clients to that same endpoint.
Configuration
| Env | Default | Purpose |
|---|---|---|
FIND_MCP_URL |
https://catalog.agentage.io/mcp |
Override the upstream endpoint (dev) |
CATALOG_MCP_URL |
- | Deprecated alias for FIND_MCP_URL, still accepted |
Develop
npm install
npm test # vitest: in-process mock-upstream contract + forwarding tests
LIVE_SMOKE=1 npm test # also runs the live smoke against the real endpoint
npm run verify # type-check + lint + format:check + test + build
Release
Releases publish to npm via GitHub Actions when a chore(release): vX.Y.Z commit that touches
package.json lands on master (the squash-merge subject of a release PR). The workflow skips
any version already on npm.
License
MIT - see LICENSE.
agentage MCP directory MCP questions
How do I add agentage MCP directory MCP to Claude Code?
Run claude mcp add find-mcp -- npx -y @agentage/find-mcp in your terminal. Add --scope user to make it available in every project.
How do I add agentage MCP directory MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does agentage MCP directory MCP provide?
It exposes 3 tools, including mcp_search, mcp_get, mcp_categories.
What is find-mcp?
It is an npm client that connects stdio-only MCP clients to the public agentage MCP directory endpoint. It acts as a thin proxy with no tool logic of its own.
How do I add find-mcp to Claude Code?
Run the claude mcp add command with npx -y @agentage/find-mcp. For Claude Desktop, Cursor, or VS Code, add the npx entry to mcp.json instead.
Does find-mcp require an API key or sign-up?
No. The directory is public and read-only, with no auth or keys needed.
What tools does find-mcp expose?
It forwards mcp_search for keyword and filter search, mcp_get for a server's full details by slug, and mcp_categories for available filter values.
Can I point find-mcp at a different endpoint?
Yes, set the FIND_MCP_URL environment variable to override the upstream endpoint, for example during development.