registry-tools

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