# Legacy Loop MCP Server

**The AI-native baby registry.** Create, discover, and manage family gift registries through any AI assistant.

Ask your AI: *"I'm having a baby in August — set up a registry for me."* Legacy Loop creates a live, shareable page in seconds. Just tell the AI your family name and email, then add links from there.

## What It Does

Legacy Loop exposes 8 tools:

| Tool | Description |
|------|-------------|
| `lookup_registry` | Look up a family's registry by name — see what they need and where to buy it |
| `search_registries` | Search for baby registries and family gift pages |
| `create_registry` | Create a registry page. Sends a verification code to the email. Returns a `writeToken` for adding links. |
| `verify_email` | Verify the email with the 6-digit code. Publishes a new page or grants edit access to an existing one. Returns a `writeToken`. |
| `add_links` | Add Amazon wishlists, Target registries, Venmo, 529 funds, and more. Requires the `writeToken`. |
| `connect_registry` | Connect to an existing page by email. Sends a verification code so you can get a `writeToken` for edits. |
| `update_registry` | Update page settings (family name, welcome message, kids, due date, color theme). Requires the `writeToken`. |
| `remove_link` | Remove a link from a page. Requires the `writeToken`. |

## Quick Start

### Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "legacyloop": {
      "command": "npx",
      "args": ["-y", "@legacyloop/mcp-server"],
      "env": {
        "DATABASE_URL": "your-postgresql-connection-string"
      }
    }
  }
}
```

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `DATABASE_URL` | Yes | PostgreSQL connection string |
| `RESEND_API_KEY` | No | Resend API key for sending set-password emails |

## Example Conversations

### Creating a new registry

**User:** I'm having a baby in August, I need a registry

**AI:** I can set one up right now. What's your family name?

**User:** The Johnson Family

**AI:** And what email should I use for your account?

**User:** sarah@gmail.com

**AI:** I've created your page. Check your email for a 6-digit verification code so we can publish it.

**User:** The code is 847291

**AI:** Verified. Your registry is live at **legacyloop.me/family/johnson-family**

Want to add any wishlists or gift funds?

**User:** Add my Amazon wishlist — amazon.com/hz/wishlist/ls/ABC123

**AI:** Done. Anyone who visits your link can see it and shop directly.

### Editing an existing registry

**User:** I want to update my Legacy Loop page

**AI:** What email is your page under?

**User:** kathaleeny@gmail.com

**AI:** *(calls connect_registry)* I sent a verification code to your email. What's the code?

**User:** 384729

**AI:** *(calls verify_email)* Connected! You have "The Stenstrom Family" page at legacyloop.me/family/stenstroms. What would you like to change?

**User:** Add our Target registry — target.com/gift-registry/stenstroms

**AI:** *(calls add_links with write token)* Done. Target registry is on your page.

**User:** Remove the old Amazon link

**AI:** *(calls remove_link with write token)* Removed.

## Links

- [Legacy Loop](https://legacyloop.me) — Create your registry
- [GitHub](https://github.com/ucsdsu/legacyloop-mcp) — Source code