MCP Registry

npx @bolthub/mcp-registry

npm install -g @bolthub/mcp-registry

{
  "mcpServers": {
    "bolthub": {
      "command": "npx",
      "args": ["@bolthub/mcp-registry"],
      "env": {
        "LND_REST_HOST": "https://your-lnd-node:8080",
        "LND_MACAROON": "<hex-admin-or-pay-macaroon>"
      }
    }
  }
}

"env": { "LND_REST_HOST": "...", "LND_MACAROON": "...", "BUDGET_SATS": "1000" }

search_apis({ query: "weather" })
search_apis({ tag: "finance" })
search_apis()  // list all available APIs

get_api_details({ slug: "btc-intel" })

preview_cost({ slug: "btc-intel", path: "/v1/history/candles" })

call_api({ slug: "btc-intel", path: "/v1/history/candles", method: "GET" })
call_api({ slug: "my-api", path: "/analyze", method: "POST", body: { text: "hello" }, max_cost_sats: 50 })

deploy_node({ provider: "hetzner", api_key: "<vps-api-key>" })
deploy_node({ provider: "scaleway", api_key: "<vps-api-key>", region: "fr-par", tor: true })

node_status({ node_id: "<node-id-from-deploy_node>" })

`@bolthub/mcp-registry` is an MCP server that gives AI agents access to every API on the bolthub marketplace through one MCP config entry.

It exposes six stable tools:
- `search_apis`: discover APIs by query/tag
- `get_api_details`: fetch endpoint and pricing metadata
- `preview_cost`: estimate sats before calling
- `call_api`: execute API requests with automatic L402 payment
- `deploy_node`: provision a self-custodial Lightning node via the Node Launcher
- `node_status`: check deployment progress for a Node Launcher node

Install:
`npx @bolthub/mcp-registry`

## Compatibility
- Transport: `stdio`
- Clients tested: Cursor, Claude Desktop, Claude Code
- Runtime: Node.js LTS with `npx`

## Required configuration
Set one wallet integration:
- LND: `LND_REST_HOST`, `LND_MACAROON` (recommended)
- NWC: `NWC_URI` (easiest setup, no node required)
- LNbits: `LNBITS_URL`, `LNBITS_ADMIN_KEY` (if you already run LNbits)
- Phoenixd: `PHOENIXD_URL`, `PHOENIXD_PASSWORD` (if you already run Phoenixd)

Optional:
- `BUDGET_SATS` to cap per-session spending

## Security model
- The server can make outbound HTTP calls to APIs selected by the user/agent.
- Payment is explicit and auditable through Lightning invoice settlement.
- `BUDGET_SATS` provides a hard cap to prevent overspend.
- Secrets are read from environment variables; never hardcode credentials.
- Tool schema is intentionally small and stable to reduce prompt-surface risk.

# Clean environment
node -v
npx @bolthub/mcp-registry --help || true

# With wallet env configured, validate startup
LND_REST_HOST=... LND_MACAROON=... npx @bolthub/mcp-registry

## MCP server submission: @bolthub/mcp-registry

### What it does
Provides a single MCP server entry that exposes every API listed on bolthub.ai.

### Install
`npx @bolthub/mcp-registry`

### Transport
`stdio`

### Authentication / secrets
Uses wallet credentials via environment variables (LND or NWC recommended; LNbits and Phoenixd also supported). Supports optional spend cap with `BUDGET_SATS`.

### Tools
- `search_apis`
- `get_api_details`
- `preview_cost`
- `call_api`
- `deploy_node`
- `node_status`

### Quick validation performed
- [ ] Starts on a clean machine with the documented command
- [ ] Env var requirements documented and verified
- [ ] README includes examples for Cursor/Claude setup
- [ ] Security considerations documented
- [ ] License and CI checks present

## Server name
bolthub

## Package
@bolthub/mcp-registry

## Install command
npx @bolthub/mcp-registry

## Category
Developer tools / API marketplace

## Description
One MCP config entry that gives AI agents discover + call access to every API on the bolthub marketplace.

## Transport
stdio

## Auth and secrets
Configured via env vars for one wallet type:
- LND_REST_HOST + LND_MACAROON (recommended)
- NWC_URI (easiest, no node required)
- LNBITS_URL + LNBITS_ADMIN_KEY
- PHOENIXD_URL + PHOENIXD_PASSWORD

Optional:
- BUDGET_SATS (session spending cap)

## Exposed tools
- search_apis
- get_api_details
- preview_cost
- call_api
- deploy_node
- node_status

## Verification notes
- Validated startup from clean environment
- README includes Cursor/Claude setup
- Security section documents secrets handling and spend limits

{
  "name": "bolthub",
  "display_name": "bolthub MCP Registry",
  "package": {
    "manager": "npm",
    "name": "@bolthub/mcp-registry",
    "install": "npx @bolthub/mcp-registry"
  },
  "description": "One MCP config entry to discover and call every API on the bolthub marketplace.",
  "transport": ["stdio"],
  "documentation_url": "https://bolthub.ai/docs/sdks/mcp-registry",
  "repository_url": "https://github.com/signaltech-org/bolthub-sdk",
  "license": "MIT",
  "tools": [
    {
      "name": "search_apis",
      "description": "Search marketplace APIs by query or tag."
    },
    {
      "name": "get_api_details",
      "description": "Get endpoint specs, examples, and pricing metadata."
    },
    {
      "name": "preview_cost",
      "description": "Estimate sats cost before making a paid request."
    },
    {
      "name": "call_api",
      "description": "Call an endpoint with automatic L402 Lightning payment."
    },
    {
      "name": "deploy_node",
      "description": "Deploy a non-custodial Lightning node on a VPS via the Node Launcher."
    },
    {
      "name": "node_status",
      "description": "Check progress and connection details for a Node Launcher deployment."
    }
  ],
  "env": {
    "one_of": [
      ["LND_REST_HOST", "LND_MACAROON"],
      ["NWC_URI"],
      ["LNBITS_URL", "LNBITS_ADMIN_KEY"],
      ["PHOENIXD_URL", "PHOENIXD_PASSWORD"]
    ],
    "optional": ["BUDGET_SATS"]
  },
  "security": {
    "secrets_source": "environment variables",
    "network_access": "outbound HTTP requests to selected APIs",
    "cost_controls": ["BUDGET_SATS"]
  },
  "compatibility": {
    "clients_tested": ["Cursor", "Claude Desktop", "Claude Code"]
  }
}

## MCP server submission: bolthub

### Package
`@bolthub/mcp-registry`

### Repository
`https://github.com/signaltech-org/bolthub-sdk` (directory: `packages/mcp-registry`)

### Documentation
`https://docs.bolthub.ai/docs/sdks/mcp-registry`

### Install
`npx @bolthub/mcp-registry`

### Description
`@bolthub/mcp-registry` is an MCP server that gives AI agents discover + call access to every API on the bolthub marketplace via one MCP config entry.

### Transport
`stdio`

### Authentication / secrets
One wallet integration is required (via env vars):
- `LND_REST_HOST` + `LND_MACAROON` (recommended)
- `NWC_URI` (easiest, no node required)
- `LNBITS_URL` + `LNBITS_ADMIN_KEY`
- `PHOENIXD_URL` + `PHOENIXD_PASSWORD`

Optional:
- `BUDGET_SATS` (hard spend cap per MCP server session)

### Exposed tools
- `search_apis` (discover APIs by query/tag)
- `get_api_details` (fetch endpoint/pricing metadata)
- `preview_cost` (estimate sats cost before execution)
- `call_api` (execute endpoint with automatic L402 payment)
- `deploy_node` (provision a non-custodial Lightning node via the Node Launcher)
- `node_status` (check provisioning progress for a Node Launcher node)

### License
`MIT`

### Validation checklist
- [x] Install command works on clean machine: `npx @bolthub/mcp-registry`
- [x] Env var requirements documented for all wallet modes
- [x] Cursor/Claude setup examples documented
- [x] Cost control documented (`BUDGET_SATS`)
- [x] Open-source license declared

{
  "name": "bolthub",
  "display_name": "bolthub MCP Registry",
  "package": {
    "manager": "npm",
    "name": "@bolthub/mcp-registry",
    "version": "0.1.4",
    "install": "npx @bolthub/mcp-registry"
  },
  "description": "MCP server that gives AI agents discover and call access to every API on the bolthub marketplace through a single config entry.",
  "transport": ["stdio"],
  "documentation_url": "https://docs.bolthub.ai/docs/sdks/mcp-registry",
  "repository_url": "https://github.com/signaltech-org/bolthub-sdk",
  "repository_subdirectory": "packages/mcp-registry",
  "license": "MIT",
  "tools": [
    {
      "name": "search_apis",
      "description": "Search marketplace APIs by query or tag."
    },
    {
      "name": "get_api_details",
      "description": "Get endpoint specs, examples, and pricing metadata for a slug."
    },
    {
      "name": "preview_cost",
      "description": "Preview sats cost before making a paid endpoint request."
    },
    {
      "name": "call_api",
      "description": "Call an API endpoint with automatic L402 Lightning payment handling."
    },
    {
      "name": "deploy_node",
      "description": "Deploy a non-custodial Lightning node on a VPS via the bolthub Node Launcher."
    },
    {
      "name": "node_status",
      "description": "Check the deployment status and connection details for a Node Launcher node."
    }
  ],
  "env": {
    "one_of": [
      ["LND_REST_HOST", "LND_MACAROON"],
      ["NWC_URI"],
      ["LNBITS_URL", "LNBITS_ADMIN_KEY"],
      ["PHOENIXD_URL", "PHOENIXD_PASSWORD"]
    ],
    "optional": ["BUDGET_SATS"]
  },
  "security": {
    "secrets_source": "environment variables",
    "network_access": "outbound HTTP requests to selected marketplace APIs",
    "cost_controls": ["BUDGET_SATS"]
  },
  "compatibility": {
    "clients_tested": ["Cursor", "Claude Desktop", "Claude Code"]
  }
}