# iranti

Shared memory for AI agents: facts, checkpoints and semantic search that survive a restart. Useful when context vanishes between sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: nfemmanuel
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nfemmanuel/iranti
- Updated: 2026-07-06
- HTML: https://affpapa.org/en/nevibecode/mcp/iranti

## What it does

iranti is an MCP server that keeps agent facts and checkpoints and searches them semantically. The store is shared, so several agents read the same memory instead of each keeping its own.

It runs with `npx -y iranti`. You need `DATABASE_URL` and `IRANTI_API_KEY`, plus `IRANTI_URL` in some setups. No database and no key means the server will not come up, so sort out the connection first.

Works with Claude, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed and Gemini CLI. Everywhere it is a stdio server: the `npx` command, the `-y iranti` argument, environment variables in the config.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DATABASE_URL`, `IRANTI_API_KEY`, `IRANTI_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DATABASE_URL=<DATABASE_URL> --env IRANTI_API_KEY=<IRANTI_API_KEY> --env IRANTI_URL=<IRANTI_URL> --transport stdio iranti -- npx -y iranti
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add iranti --env DATABASE_URL=<DATABASE_URL> --env IRANTI_API_KEY=<IRANTI_API_KEY> --env IRANTI_URL=<IRANTI_URL> -- npx -y iranti
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "iranti": {
            "command": "npx",
            "args": [
                "-y",
                "iranti"
            ],
            "env": {
                "DATABASE_URL": "<DATABASE_URL>",
                "IRANTI_API_KEY": "<IRANTI_API_KEY>",
                "IRANTI_URL": "<IRANTI_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "iranti": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "iranti"
            ],
            "env": {
                "DATABASE_URL": "<DATABASE_URL>",
                "IRANTI_API_KEY": "<IRANTI_API_KEY>",
                "IRANTI_URL": "<IRANTI_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DATABASE_URL=<DATABASE_URL> -e IRANTI_API_KEY=<IRANTI_API_KEY> -e IRANTI_URL=<IRANTI_URL> iranti npx -y iranti
```
Replace <…> with your own values

## When to use it
- keep project facts across agent sessions
- find a stored fact by meaning instead of grepping logs
- set a checkpoint before a risky refactor
- share one memory between several agents
- restore context after restarting the IDE

## Example prompts
- Save to iranti: this project runs PostgreSQL 16
- Search iranti memory for everything we decided about auth
- Create an iranti checkpoint before the schema migration

## Similar
- [recall](https://affpapa.org/en/nevibecode/skills/parcadei-recall.md) — skill · 493 installs
- [openchronicle-mcp](https://affpapa.org/en/nevibecode/mcp/openchronicle-mcp.md) — MCP server · ★ 16
- [hot-memory-mcp](https://affpapa.org/en/nevibecode/mcp/hot-memory-mcp.md) — MCP server · ★ 14
- [longhand](https://affpapa.org/en/nevibecode/plugins/longhand.md) — plugin · ★ 14
- [agentdb-query](https://affpapa.org/en/nevibecode/skills/agentdb-query.md) — skill · 745 installs
- [openviking-memory](https://affpapa.org/en/nevibecode/skills/openviking-memory.md) — skill · 504 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md