com.macaroonnetwork/mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LND_BUYER_TLS | No | Path to your LND TLS certificate, e.g. /path/to/tls.cert. Used only when MACAROONS_BUYER_LND_MODE is set. | |
| LND_BUYER_HOST | No | Host and port of your LND node, e.g. your-node:10009. Used only when MACAROONS_BUYER_LND_MODE is set. | |
| LND_BUYER_MACAROON | No | Path to your LND admin macaroon, e.g. /path/to/admin.macaroon. Used only when MACAROONS_BUYER_LND_MODE is set. | |
| MACAROONS_FEED_URL | No | Override the feed URL. Defaults to https://api.macaroonnetwork.com if not set. | |
| MACAROONS_REGISTRY_URL | No | Override the registry URL. Defaults to https://api.macaroonnetwork.com if not set. | |
| MACAROONS_BUYER_LND_MODE | No | Set to "external" to enable auto-payment via an external LND node. If unset, the server returns payment_required results instead of auto-paying. | |
| MACAROONS_SESSION_BUDGET_SATS | No | Caps total spend per server process in satoshis. Defaults to 1000. | 1000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| macaroons_searchA | Search Macaroon Network for capabilities matching an intent. Returns ranked listings with price, predicate hash, and freshness. Free, no payment required. |
| macaroons_metadataA | Get free metadata for a feed target before purchasing. Returns freshness and content_hash. No payment required. |
| macaroons_purchaseA | Purchase change-events for a feed target. Pays via Lightning L402 against a hold invoice — payment only settles if the acceptance predicate passes against the delivered payload; otherwise it is fully refunded. If no wallet is configured (the default), returns payment_required with a real invoice for you to pay yourself. |
| macaroons_executeA | Execute a paid marketplace capability by capability_id. Pays via Lightning L402 against a hold invoice — payment only settles if the acceptance predicate passes against the bridge response; bridge errors and predicate failures refund. If no wallet is configured (the default), returns payment_required with a real invoice for you to pay yourself. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool targets a distinct stage: search discovers capabilities, metadata inspects a specific feed target pre-purchase, purchase acquires change-events, and execute runs a paid capability. Search and metadata both return freshness, which causes slight overlap, but their inputs and outputs are different enough for an agent to choose correctly.
All tools share the macaroons_ prefix and mostly follow a macaroons_<action> pattern. Three are clear verbs (search, purchase, execute), while metadata is a noun rather than get_metadata, creating a minor inconsistency but not a confusing one.
Four tools is well-scoped for this marketplace-focused server: discover, inspect, acquire, and use. Each tool has a clear purpose and none feel redundant or extraneous.
The core lifecycle for a paid capability marketplace is covered: find capabilities, inspect feed metadata, purchase change-events, and execute capabilities. A minor gap is the lack of a tool to list previously purchased capabilities or check wallet/payment status, but agents can likely work around that using returned capability IDs.