Is Albyhub Admin free?

Yes, Albyhub Admin is free to use.

How do I install Albyhub Admin?

Albyhub Admin is a local plugin. Install it using npm package: albyhub-admin-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Albyhub Admin need?

Albyhub Admin requires the following credentials or environment variables: ALBYHUB_URL, ALBYHUB_TOKEN, ALBYHUB_READ_ONLY. You can find setup instructions on the server detail page.

What AI apps work with Albyhub Admin?

Albyhub Admin uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Albyhub Admin MCP Server

by Llmops Pro

Developer ToolsUse Caution4.8MCP RegistryLocal

Free

Server data from the Official MCP Registry

Admin an Alby Hub Lightning node from an agent: info, balances, channels; safety-gated writes.

About

Admin an Alby Hub Lightning node from an agent: info, balances, channels; safety-gated writes.

Security Report

4.8

Use Caution4.8High Risk

This MCP server implements a thoughtful safety model with multiple layers of protection for accessing an Alby Hub admin API. The code is well-structured with proper authentication via bearer tokens, rate limiting, optional confirmation gates, and comprehensive audit logging. Minor code quality issues around error handling breadth and input validation do not significantly impact security, as the server's permissions (network access to a configured Hub instance) align appropriately with its purpose as a developer tool. Supply chain analysis found 5 known vulnerabilities in dependencies (2 critical, 2 high severity). Package verification found 1 issue.

7 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

What You'll Need

Set these up before or after installing:

Base URL of the Alby Hub instanceOptional

Environment variable: ALBYHUB_URL

Alby Hub API bearer tokenRequired

Environment variable: ALBYHUB_TOKEN

Set true to block all write operations (recommended for first-time setup)Optional

Environment variable: ALBYHUB_READ_ONLY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-llmops-pro-albyhub-admin-mcp": {
      "env": {
        "ALBYHUB_URL": "your-albyhub-url-here",
        "ALBYHUB_TOKEN": "your-albyhub-token-here",
        "ALBYHUB_READ_ONLY": "your-albyhub-read-only-here"
      },
      "args": [
        "-y",
        "albyhub-admin-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

albyhub-admin-mcp

Node-admin operations on your Alby Hub, exposed to an LLM agent. MCP server that wraps the Alby Hub HTTP API — read node info, balances, channels, NWC sub-wallets. Where NWC (nwc-mcp) ends (it's wallet-scoped), this server picks up: hub-wide on-chain balance, channel state, sub-wallet inventory.

v0.1 — defensive design. Alby Hub's admin API has evolved across versions and isn't publicly versioned in a stable way. So v0.1 ships one generic proxy tool that hits any path (the escape hatch) plus typed wrappers around a few well-established endpoints. If a typed wrapper's endpoint-guess fails against your Hub version, the proxy lets you discover the right path without re-shipping. v0.2 hardens the typed wrappers once smoke-tested against real Hubs.

The six tools

Tool	Method	Path	Purpose
`albyhub_proxy_request`	*	*	Generic HTTP proxy — escape hatch for any endpoint not yet wrapped.
`albyhub_confirm_request`	*	*	Two-step confirm dispatcher for proxy_request.
`albyhub_get_node_info`	GET	`/api/info`	Node identity, network, version.
`albyhub_get_balances`	GET	`/api/balances`	On-chain + Lightning aggregate balances.
`albyhub_list_apps`	GET	`/api/apps`	NWC connections (sub-wallets) provisioned on this hub.
`albyhub_list_channels`	GET	`/api/channels`	Lightning channels with status + capacities.

All typed wrappers are safe GETs. Non-GET behavior runs through albyhub_proxy_request, which is gated by ALBYHUB_READ_ONLY and ALBYHUB_REQUIRE_CONFIRM.

Requirements

Node 20+
A running Alby Hub instance (desktop app on http://localhost:8080, or self-hosted exposed somewhere)
An Alby Hub API token (Settings → Developer / Apps in the Hub UI)

Install

npx -y albyhub-admin-mcp

Configure

cp .env.example .env
# edit .env: set ALBYHUB_URL (default http://localhost:8080) + ALBYHUB_TOKEN

Required

Var	Purpose
`ALBYHUB_URL`	Base URL of your Hub. Default `http://localhost:8080`. Use HTTPS if exposed remotely.
`ALBYHUB_TOKEN`	API access token. Full-scope tokens can drain the hub's on-chain balance — scope down or use ALBYHUB_READ_ONLY=true if your audience matters.

Optional safety knobs

Var	Default	Purpose
`ALBYHUB_READ_ONLY`	`false`	Refuse all non-GET requests via `proxy_request`. Strongly recommended for first-time setup.
`ALBYHUB_REQUIRE_CONFIRM`	`false`	Two-step confirm for non-GET requests.
`ALBYHUB_MAX_REQUESTS_PER_MINUTE`	`30`	Rolling 60s rate limit.
`ALBYHUB_LOG_PATH`	`./albyhub-admin-mcp.log`	Server log.
`ALBYHUB_AUDIT_PATH`	`./albyhub-admin-mcp-audit.log`	Append-only JSON-line audit log.

What if my Hub returns 404 on the typed wrappers?

The endpoint path probably differs in your Hub version. Use albyhub_proxy_request to probe — try /api/node, /info, /api/v1/info, etc. Once you find the right path, you can pin it in your usage (and ping the maintainer to fix the typed wrapper in v0.2).

agent: albyhub_proxy_request({ method: "GET", path: "/api/v1/info" })
→ { status: 200, body: { ... } }   // found it

Safety model

The proxy tool's pipeline:

ALBYHUB_READ_ONLY gate — non-GET requests blocked outright.
Rate limit — rolling 60s window on the requests bucket.
ALBYHUB_REQUIRE_CONFIRM gate — non-GET requests return a token; albyhub_confirm_request executes.
HTTP request — Bearer auth, 15s timeout (override via timeout_ms).
Audit log — every attempt (ok / blocked / error) as one structured JSON line.

GET-only convenience wrappers skip steps 1 + 3 (they're safe by construction) but still go through rate limit + audit.

Companion servers

nwc-mcp — wallet ops via NIP-47. Use this for per-sub-wallet spend; use albyhub-admin-mcp for hub-wide / node-level operations.
nostr-ops-mcp — NOSTR identity + publishing.
marketplace-mcp — NIP-15 marketplace storefront.

License

MIT — see LICENSE.

Contact / Issues

Built by LLMOps.Pro.

NOSTR: npub1hdg932jvwc3jdvkqywgqv0ue4nn60exrf92asy8mtazt3hjg7d2s2yw0nw — follow, DM, zap.
Lightning Address: sovereigncitizens@getalby.com — for support zaps and "this was useful" tips.
Bug reports / feature requests: open a GitHub issue (link forthcoming).
Security issues: please disclose privately via NOSTR DM before opening a public issue.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Albyhub Admin MCP Server

About

Security Report

Findings (11)Action required

Permissions Required

What You'll Need

How to Install

Documentation

albyhub-admin-mcp

The six tools

Requirements

Install

Configure

Required

Optional safety knobs

What if my Hub returns 404 on the typed wrappers?

Safety model

Companion servers

License

Contact / Issues

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Git

Toleno

mcp-creator-python

MarkItDown

FinAgent