Lightning Memory

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/singularityjason-lightning-memory

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

12 read · 7 write · 0 delete · 3 not yet classified

Secrets

None asked for

Install scripts

Not scanned yet

Runs as

Python package

Tools (22)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• ln_agent_attest

  Store an attestation about an agent's identity and compliance status. Used for Know Your Agent (KYA) — agents self-attesting, operators attesting their agents, or third-party KYA providers. Args: agent_pubkey: The agent's Nostr public key (64 hex chars). owner_id: Owner identifier (email, company name, etc.). jurisdiction: Legal jurisdiction (e.g., "US", "EU", "SG"). compliance_level: One of: unknown, self_declared, kyc_verified, regulated_entity. source: Verification source (e.g., "manual", "sumsub", "trulioo"). Returns: The stored attestation record.

• ln_agent_verify

  Look up an agent's compliance attestation. Args: agent_pubkey: The agent's Nostr public key to verify. Returns: Attestation details or {status: "unknown"} if not found.

• ln_anomaly_check

  Check if a proposed payment amount is normal for a vendor. Use this before making a payment to catch price anomalies. Compares the proposed amount against historical averages. Args: vendor: Vendor name or domain. amount_sats: Proposed payment amount in satoshis. Returns: Anomaly report: verdict (normal/high/first_time), context, and historical average.

• ln_auth_lookup

  Check if an LNURL-auth session exists with a vendor. Args: vendor: Vendor name or domain to check. Returns: Session details if found, or {has_session: false}.

• ln_auth_session

  Store or update an LNURL-auth session record. Record-keeping for externally-established LNURL-auth sessions. Args: vendor: Vendor name or domain. linking_key: The LNURL-auth linking key for this vendor. session_state: Session state: active, expired, or revoked. Returns: The stored session record.

• ln_budget_check

  List budget rules and current spending status. Shows all active budget rules, or details for a specific vendor including how much has been spent today and this month. Args: vendor: Optional vendor to check. If omitted, lists all rules. Returns: Budget rules with current spending against limits.

• ln_budget_set

  Set spending limits for a vendor. Creates budget rules that the pre-flight gate enforces. Any payment exceeding these limits will be rejected. Args: vendor: Vendor name or domain (e.g., "bitrefill.com"). max_sats_per_txn: Maximum sats allowed per single transaction. max_sats_per_day: Maximum total sats per day to this vendor. max_sats_per_month: Maximum total sats per month to this vendor. Returns: The created/updated budget rule.

• ln_budget_status

  Check L402 gateway earnings and payment stats. Shows total sats earned from L402 gateway payments, broken down by operation. Reads from locally stored payment records (logged by the gateway). Returns: Earnings summary: total sats, payment count, breakdown by operation.

• ln_compliance_report

  Generate a structured compliance report. Produces a comprehensive report covering agent identity, transactions, budget rules, vendor KYC status, anomaly flags, and trust attestations. Designed for regulatory compliance export. Args: since: Time period for temporal data. Relative: "1h", "24h", "7d", "30d". Current-state data (budget rules, KYC) is always included. format: Output format. Only "json" supported in v1. Returns: Compliance report as a structured dict.

• ln_discover_gateways

  List known Lightning Memory gateways discovered via Nostr relays. Args: operation: Optional filter — only return gateways offering this operation (e.g., "memory_query", "ln_vendor_reputation"). Returns: List of known gateways with URL, operations, pricing, and last seen time.

• ln_preflight

  Pre-flight check before making a payment. Runs budget limits, anomaly detection, and trust verification to produce an approve/reject/escalate decision. Use this before every payment to catch overspending, price anomalies, and unverified vendors. Args: vendor: Vendor name or domain. amount_sats: Proposed payment amount in satoshis. Returns: Decision: verdict (approve/reject/escalate), reasons, budget remaining, anomaly status, and trust score.

• ln_remote_query

  Query a remote Lightning Memory gateway via L402 micropayment. Pays the gateway's Lightning invoice automatically via Phoenixd, then returns the query results. The payment is logged as a transaction memory. Args: gateway_url: URL of the remote gateway (e.g., "https://gw.example.com"). operation: Operation to perform. One of: memory_query, memory_list, ln_vendor_reputation, ln_spending_summary, ln_anomaly_check, ln_preflight, ln_vendor_trust, ln_budget_check, ln_compliance_report. params: JSON string of operation-specific parameters. Returns: Rem…

• ln_spending_summary

  Get a spending summary for budget awareness. Shows total sats spent, broken down by vendor and protocol. Args: since: Time period. Relative: "1h", "24h", "7d", "30d". Or Unix timestamp. Returns: Spending breakdown with totals by vendor and protocol.

• ln_trust_attest

  Publish a trust attestation for a vendor. Creates a NIP-85 Trusted Assertion and pushes it to Nostr relays. Other agents can pull these attestations to build community reputation. Args: vendor: Vendor name or domain to attest. score: Trust score 0.0-1.0. If omitted, auto-calculated from local reputation (success_rate * volume factor). basis: Reason for the score (default: "transaction_history"). Returns: Attestation details including score and relay push status.

• ln_vendor_reputation

  Check a vendor's reputation based on transaction history. Use this before paying a vendor to see if they're reliable. Aggregates all past transactions to build a reputation score. Args: vendor: Vendor name or domain (e.g., "bitrefill.com", "openai"). Returns: Reputation report: total transactions, total sats spent, success rate, average payment size, and tags.

Signals

Stars

9

Forks

5

Open issues

2

Weekly downloads

19

Last commit

Mar 25, 2026 (7 months ago)

Last release

Mar 4, 2026 (7 months ago)

Last package publish

Mar 25, 2026 (7 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.singularityjason/lightning-memory

Version

0.4.1

Auth

No auth

Packages

pypi lightning-memory

License

MIT

Repository

github.com/singularityjason/lightning-memory

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql