Registry Tools MCP Server

Search and resolve MCP server packages on the mpak registry. This server lets agents discover available MCP servers, inspect their tools, and check credential requirements before installation.

This is one of the core MCP servers that powers NimbleBrain's agent runtime, giving agents self-service access to the registry. It's open source so you can see how it works, fork it to connect to your own registry, or use it as a reference for building discovery-layer MCP servers.

Install

mpak install @nimblebraininc/registry-tools

<details> <summary>Claude Code</summary>

claude mcp add registry-tools -- mpak run @nimblebraininc/registry-tools

</details>

<details> <summary>Claude Desktop</summary>

{
  "mcpServers": {
    "registry-tools": {
      "command": "mpak",
      "args": ["run", "@nimblebraininc/registry-tools"]
    }
  }
}

</details>

Tools

registry_search

Search the mpak registry for available MCP servers.

Parameter	Type	Required	Description
query	string	Yes	Search term (e.g., "weather", "pdf", "finance")

Returns matching packages with name, description, tools, download count, and verification status.

registry_resolve

Get full metadata for a specific package, including credential requirements and version history.

Parameter	Type	Required	Description
package	string	Yes	Package identifier (e.g., "@nimblebraininc/finnhub")
version	string	No	Specific version (omit for latest)

Returns detailed package info including tools, required credentials, license, and homepage.

Configuration

Env Var	Required	Description
REGISTRY_URL	No	mpak registry URL (default: https://registry.mpak.dev)

Extending

Want to adapt this for your own infrastructure?

• Point REGISTRY_URL at your own registry endpoint
• Add a registry_browse tool that lists categories or popular servers
• Add tools that combine search with automatic installation via your orchestrator
• Fork and modify src/mcp_registry_tools/server.py

Development

git clone https://github.com/NimbleBrainInc/mcp-registry-tools.git
cd mcp-registry-tools

# Install dependencies
uv sync --group dev

# Run all checks (format, lint, typecheck, tests)
make check

# Run the server locally (stdio)
uv run python -m mcp_registry_tools.server

# Run the server locally (HTTP)
make run-http

License

MIT