Provena Agent Memory

Name: Provena Agent Memory
Author: admiralpunk

admiralpunk

Self-hosted memory for AI agents via MCP. Capture source events, retrieve context across sessions, and explain evidence-backed claims.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add provena-agent-memory --env PROVENA_API_KEY='<PROVENA_API_KEY>' --env PROVENA_SCOPE_ID='<PROVENA_SCOPE_ID>' -- uvx provena-agent-memory

~/.codex/config.toml

[mcp_servers.provena-agent-memory]
command = "uvx"
args = ["provena-agent-memory"]
env = { PROVENA_API_KEY = "<PROVENA_API_KEY>", PROVENA_SCOPE_ID = "<PROVENA_SCOPE_ID>" }

# codex mcp add provena-agent-memory --env PROVENA_API_KEY='<PROVENA_API_KEY>' --env PROVENA_SCOPE_ID='<PROVENA_SCOPE_ID>' -- uvx provena-agent-memory

~/.cursor/mcp.json

{
  "mcpServers": {
    "provena-agent-memory": {
      "command": "uvx",
      "args": [
        "provena-agent-memory"
      ],
      "env": {
        "PROVENA_API_KEY": "<PROVENA_API_KEY>",
        "PROVENA_SCOPE_ID": "<PROVENA_SCOPE_ID>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "provena-agent-memory": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "provena-agent-memory"
      ],
      "env": {
        "PROVENA_API_KEY": "<PROVENA_API_KEY>",
        "PROVENA_SCOPE_ID": "<PROVENA_SCOPE_ID>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "provena-agent-memory": {
      "command": "uvx",
      "args": [
        "provena-agent-memory"
      ],
      "env": {
        "PROVENA_API_KEY": "<PROVENA_API_KEY>",
        "PROVENA_SCOPE_ID": "<PROVENA_SCOPE_ID>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "provena-agent-memory": {
      "command": "uvx",
      "args": [
        "provena-agent-memory"
      ],
      "env": {
        "PROVENA_API_KEY": "<PROVENA_API_KEY>",
        "PROVENA_SCOPE_ID": "<PROVENA_SCOPE_ID>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "provena-agent-memory": {
      "command": "uvx",
      "args": [
        "provena-agent-memory"
      ],
      "env": {
        "PROVENA_API_KEY": "<PROVENA_API_KEY>",
        "PROVENA_SCOPE_ID": "<PROVENA_SCOPE_ID>"
      }
    }
  }
}

Environment variables

PROVENA_API_KEY
PROVENA_SCOPE_ID

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related