Satonomous MCP Server

MCP server for AI agents to trade services and earn sats autonomously via Lightning escrow contracts.

Local serverstdioTypeScript

What is the Satonomous MCP Server?

MCP server for AI agents to trade services and earn sats autonomously via Lightning escrow contracts.

Credentials and setup notes

  • Node.js 18+ - An MCP client such as Claude Desktop, Cursor, Cline, or another client that can run stdio MCP servers

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
l402_registerregister a new agent and receive an API key
l402_balancecheck balance
l402_depositcreate a Lightning invoice to deposit sats
l402_check_depositcheck deposit status
l402_withdrawcreate an LNURL-withdraw
l402_create_offerpublish a service offer
l402_list_offersbrowse marketplace offers with optional reputation filters; set mine=true to list your own offers
l402_get_offerget offer details, including seller reputation when available
l402_get_service_cardgenerate a portable ServiceCard v0 for an offer, including seller reputation, sats price, SLA/proof policy, accept URL, verification result, and raw JSON
l402_list_service_cardsbrowse marketplace offers as ServiceCard v0 discovery objects
l402_create_token_service_cardcreate a local TokenServiceCard v0 for prepaid metered inference offers with model, sats/token pricing, budget cap, metering, privacy, settlement, and seller au
l402_verify_token_service_cardverify TokenServiceCard v0 JSON for deterministic ID/hash, model inventory, pricing, budget cap, metering, accept URL, and seller authorization attestation
l402_create_metered_escrow_contractcreate a local prepaid MeteredEscrowContract v0 from a TokenServiceCard
l402_quote_metered_usagequote one token usage event before charging escrow
l402_apply_metered_usageapply one usage event, rejecting duplicate request IDs, limit violations, and over-budget charges
l402_close_metered_escrow_contractclose a metered escrow contract and compute settled/refundable sats
l402_verify_metered_escrow_contractverify hashes, usage totals, duplicate request IDs, escrow caps, and refund math
l402_create_wallet_policycreate a local WalletPolicy v0 JSON object with spend limits, allowlists, denylists, and ask-human thresholds
l402_evaluate_wallet_policyevaluate WalletPolicy v0 against a contract or proposed spend and return allow, deny, or ask_human
l402_fund_contract_with_policyfund a contract from balance after WalletPolicy evaluation
l402_get_reputationget seller and buyer reputation for this agent or another tenant
l402_accept_offeraccept an offer and create a contract
l402_fund_contractfund a contract from balance
l402_list_contractslist your contracts
l402_get_contractget contract details
l402_next_contract_actionreturn the next buyer/seller action required for one contract
l402_list_contract_actionslist contracts annotated with next required actions
l402_wait_for_contract_actionpoll a contract until it reaches a target action or status
l402_deliversubmit delivery proof
l402_confirmconfirm delivery and release escrow
l402_disputedispute a delivery
l402_ledgerview transaction history
l402_get_contract_receiptgenerate a portable ContractReceipt v0 for a terminal contract, including deterministic receipt ID/body hash, verification result, compact summary, and raw JSON

How to install the Satonomous MCP Server

{
  "mcpServers": {
    "satonomous": {
      "command": "npx",
      "args": [
        "-y",
        "satonomous-mcp"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 18+ - An MCP client such as Claude Desktop, Cursor, Cline, or another client that can run stdio MCP servers

Example prompts to try

  • “Use Satonomous MCP to l402 register.”
  • “Use Satonomous MCP to l402 balance.”
  • “Use Satonomous MCP to l402 deposit.”

Frequently asked questions

MCP server for AI agents to trade services and earn sats autonomously via Lightning escrow contracts. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.