Lightning Memory MCP Server

Persistent memory for AI agents in the Lightning economy. AI agents spend sats over Lightning via L402 - but they can't remember what they bought. Every session starts from zero. Every vendor is a stranger. Every price is accepted at face value. An agent that paid 500 sats yesterday doesn't know if today's 5,000 sat invoice is a price spike or normal. Its README documents 6 tools, including memory_store, memory_query, memory_list.

People who work with agent memory, bitcoin and l402 and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-03-25 · ★ 9 · #254 OF 304 MAINTAINED MEMORY · VERIFIED 2026-09-18

MIT · Python servers · how we verify → /methodology

01 · Install Lightning Memory

before you install - you'll need

Set PHOENIXD_PASSWORD before connecting.

Claude Code

claude mcp add singularityjason-lightning-memory -- uvx lightning-memory

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "singularityjason-lightning-memory": {
      "command": "uvx",
      "args": [
        "lightning-memory"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package lightning-memory - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.singularityjason is GitHub-verified and matches the repo owner

03 · What Lightning Memory can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can search by relevance (FTS5 + optional semantic search), list memories with type/time filters, edit content or metadata with audit trail, and sync with Nostr relays (push/pull).

The 6 tools it gives your agent

Extracted from the project's README - what lightning-memory lets an agent do.

memory_store
- Store a memory (transaction, vendor, preference, error, decision)
memory_query
- Search by relevance (FTS5 + optional semantic search)
memory_list
- List memories with type/time filters
memory_edit
- Edit content or metadata with audit trail
memory_sync
- Sync with Nostr relays (push/pull)
memory_export
- Export as NIP-78 Nostr events

04 · Who maintains Lightning Memory

lightning-memory is maintained by singularityjason. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

category
memory - ranked #254 of 304 actively-maintained memory servers as of 2026-09-18.
registry
io.github.singularityjason/lightning-memory (active, first published 2026-03-04)
packages
pypi:lightning-memory

06 · Lightning Memory FAQ

Is Lightning Memory still maintained?

Yes - as of 2026-09-18, its last commit was 2026-03-25. We re-verify nightly.

What can Lightning Memory do?

With this server connected, an agent can search by relevance (FTS5 + optional semantic search), list memories with type/time filters, edit content or metadata with audit trail, and sync with Nostr relays (push/pull).

How do I install Lightning Memory?

Run `uvx lightning-memory`. The README documents one environment variable (PHOENIXD_PASSWORD) to set first. Set PHOENIXD_PASSWORD before connecting. You can also paste the ready-made client config above.

Does Lightning Memory run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Lightning Memory

Pairs well with

Servers that cover what Lightning Memory doesn't - only shown when the pairing reason fits the companion.

  1. Server Filesystem → filesystem companion filesystem · ★ 39,038
  2. Pdf MCP → filesystem companion filesystem · ★ 135