# Port 402 Memory

> Port 402 Memory is a paid MCP server for knowledge and memory. Persistent memory, inbox and reminders for agents, paid per call in USDC via x402. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://port-402-production.up.railway.app
- **Repository:** https://github.com/tifdt/port402-memory-mcp
- **MCP Registry name:** io.github.Tifdt/port402-memory
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

Port 402 gives an agent three things it cannot have on its own: memory that survives sessions, a secret inbox that others can post to while it is idle, and an alarm clock that wakes it later. There is no account or API key. Each call is paid in USDC on Base through the x402 protocol, and the paying wallet doubles as your private memory namespace.

Prices are tiny: writes and exports $0.002, reads, lists and deletes $0.001, a reminder $0.005, with a default hard cap of $0.01 per call (PORT402_MAX_USD_PER_CALL). The README estimates $1 of USDC at about 500 writes or 1,000 reads. Quota is 1,000 keys and 5 MB per wallet, and inbox keeps the last 200 messages.

The operator warns that values are stored unencrypted on its server, so sensitive data should be encrypted client-side, and that losing the wallet key makes the memory unreachable. Use a dedicated wallet with a few dollars of USDC. The same service is also available over plain HTTP.

## Features

- **Wallet-keyed memory:** Store, read, list, delete and export JSON values under keys tied to the paying wallet.
- **Public inbox URL:** A secret URL anyone can post to for free; you read it later.
- **Reminders:** Schedule a message from 10 seconds to 366 days out, optionally also POSTed to a webhook.
- **Signed export:** Export memory as a document with sha256 and Ed25519 integrity.
- **Spending cap:** A per-call cap defaults to $0.01.

## Good for

- Give an agent memory that persists between sessions
- Let webhooks or other agents leave messages for a sleeping agent
- Have an agent schedule its own follow-up
- Back up agent memory as a signed export

## Install

### Claude Code (Terminal)

```sh
claude mcp add port402-memory --env PORT402_PRIVATE_KEY='<PORT402_PRIVATE_KEY>' -- npx -y https://github.com/Tifdt/port402-memory-mcp/releases/download/v1.2.0/port402-memory.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "port402-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Tifdt/port402-memory-mcp/releases/download/v1.2.0/port402-memory.mcpb"
      ],
      "env": {
        "PORT402_PRIVATE_KEY": "<PORT402_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "port402-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Tifdt/port402-memory-mcp/releases/download/v1.2.0/port402-memory.mcpb"
      ],
      "env": {
        "PORT402_PRIVATE_KEY": "<PORT402_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "port402-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Tifdt/port402-memory-mcp/releases/download/v1.2.0/port402-memory.mcpb"
      ],
      "env": {
        "PORT402_PRIVATE_KEY": "<PORT402_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "port402-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Tifdt/port402-memory-mcp/releases/download/v1.2.0/port402-memory.mcpb"
      ],
      "env": {
        "PORT402_PRIVATE_KEY": "<PORT402_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "port402-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Tifdt/port402-memory-mcp/releases/download/v1.2.0/port402-memory.mcpb"
      ],
      "env": {
        "PORT402_PRIVATE_KEY": "<PORT402_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `memory_set`: Store a value under a key
- `memory_get`: Read a value, with its updatedAt time
- `memory_list`: List keys
- `memory_delete`: Delete a key
- `memory_export`: Export all memory as a signed document
- `inbox_get_url`: Get the secret inbox URL
- `inbox_read`: Read inbox messages
- `reminder_schedule`: Schedule a reminder
- `reminder_list`: List pending reminders
- `reminder_cancel`: Cancel a reminder

## FAQ

### Do I need an API key?

No. Calls are paid in USDC on Base via x402 from a dedicated wallet.

### Is memory encrypted?

Values are stored as plain JSON on the operator's server, so encrypt sensitive values first.

### What if I lose the wallet key?

Memory becomes unreachable; the service offers a key-rotation migrate call to use beforehand.

### How much memory is allowed?

1,000 keys and 5 MB per wallet.

### Is Port 402 Memory free?

No. Port 402 Memory is a paid product.

### How do I add Port 402 Memory to Claude Code?

Run this command in your terminal: claude mcp add port402-memory --env PORT402_PRIVATE_KEY='<PORT402_PRIVATE_KEY>' -- npx -y https://github.com/Tifdt/port402-memory-mcp/releases/download/v1.2.0/port402-memory.mcpb

### What are the best alternatives to Port 402 Memory?

The closest alternatives to Port 402 Memory are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/port-402-memory
