Hosted MCP server for persistent AI memory: one memory for you and your agents across Claude, Cursor and VS Code. 15 tools, Bearer key, export anytime.

AIfa Memory — Hosted Streamable HTTP MCP Server

One unified memory for you and every AI agent you connect. AIfa Memory is the official hosted Model Context Protocol server by CODE Eternal LLC. It connects Claude Code, Antigravity, Cursor, VS Code, Claude Desktop, Windsurf, Codex, or any Streamable HTTP MCP client directly to your unified CODE Eternal account memory across aifa.works, codeofdigitaleternity.com, aifa.digital, and radiocode.space.

One-click install: Install in Cursor · Get API Key · CLI (Claude Code): claude mcp add --transport http aifa-memory https://aifa.works/api/mcp --header "Authorization: Bearer <key>" · ★ Star on GitHub

Endpoint    https://aifa.works/api/mcp
Transport   Streamable HTTP (JSON-RPC 2.0, stateless)
Auth        Authorization: Bearer <your key>  (Full or Memory-Only scoped key)
Version     1.9.8 · Registry: works.aifa/aifa-memory  ·  Protocol: 2026-07-28, 2025-06-18, 2025-03-26, 2024-11-05

Table of Contents

  • Architecture: Hosted Cloud vs. Local PADAM NOCTURNE
  • Quick Start (30 Seconds)
  • Client Configurations (Claude Code · Antigravity · Cursor · VS Code · Desktop · Codex · Windsurf)
  • All 15 Tools
  • Plans & Quotas
  • Security, Isolation & Conformance Verification
  • Local Engine & Agentic Shield (padam-nocturne)
  • License & Commercial Boundary
  • Links & Contact

Architecture: Hosted Cloud vs. Local PADAM NOCTURNE

This public repository holds the protocol specification, connection templates, conformance verification runner (scripts/conformance.py), and the official MCP Registry manifest (server.json). The hosted server runs on aifa.works backed by Neon PostgreSQL and optional encrypted Arweave/Solana permanence vaults.

Capability AIfa Memory Cloud (this repo → aifa.works/api/mcp) PADAM · NOCTURNE + Agentic Shield (padam-nocturne)
Where data lives Hosted account vault (Neon PostgreSQL + optional Arweave/Solana) 100% local on your machine (1 SQLite file + Studio UI)
Shared across devices/sites Yes — instant sync across 4 sites + remote MCP clients Local-first (SQLite); optional sync via Cabinet or L3
Memory-only scoped keys Yes ({"scope": "memory"} blocks payouts/billing tools) Yes (Ed25519 Capability Leases + PADAM_STRICT=1)
Prompt injection & secret DLP Write masking, command filter, fenced read output (conformance.py) Full 4-Ring Agentic Shield v2 (214/214 RedTeam, AIFaSecurity-100 Grade S, SRI/CSP, SIEM)
Portable exit Full Markdown export via memory_export anytime Direct SQLite ownership + JSON/HTML/PA1H export
License / Pricing Docs/Examples: MIT · Hosted Cloud: Free / Paid Tiers Core/Studio: AGPL-3.0-only · CI Action: Apache-2.0 · B2B Commercial MSA

Quick Start (30 Seconds)

  1. Sign in at aifa.works/mcp and generate your personal API key (choose Memory-Only when attaching untrusted or web-browsing agents).
  2. Copy the configuration snippet for your client below and replace YOUR_AIFA_MCP_KEY.
  3. Ask your agent: "Search my AIfa memory for our architectural decisions on ..."

Client Configurations

Ready-to-copy templates are also stored in examples/.

Claude Code

claude mcp add --transport http aifa-memory https://aifa.works/api/mcp \
  --header "Authorization: Bearer YOUR_AIFA_MCP_KEY"

Antigravity / Gemini CLI (~/.gemini/antigravity/mcp_config.json or ~/.gemini/settings.json)

{
  "mcpServers": {
    "aifa-memory": {
      "serverUrl": "https://aifa.works/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AIFA_MCP_KEY"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "aifa-memory": {
      "url": "https://aifa.works/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AIFA_MCP_KEY"
      }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "aifa-memory": {
      "type": "http",
      "url": "https://aifa.works/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AIFA_MCP_KEY"
      }
    }
  }
}

OpenAI Codex (~/.codex/config.toml)

[mcp_servers.aifa-memory]
url = "https://aifa.works/api/mcp"
bearer_token_env_var = "AIFA_MCP_KEY"

Claude Desktop (claude_desktop_config.json via mcp-remote)

Claude Desktop connects to remote HTTP MCP servers through mcp-remote. Pass the header without internal spaces in args and put the token inside env (spaces inside args break header parsing on Windows).

{
  "mcpServers": {
    "aifa-memory": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://aifa.works/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer YOUR_AIFA_MCP_KEY" }
    }
  }
}

All 15 Tools

Full parameter schemas and live-verified signatures: TOOLS.md.With a memory-only key, agents only have access to the 5 Memory tools + account_status + plans; all financial, payout, and partner tools return refusal.

Memory Tools (5)

Tool Purpose
memory_search Semantic search across all conversations with AIfa across 4 sites and agent notes.
memory_recent Most recent records across channels, newest first.
memory_write Persist a preference, decision, fact, or session summary with deduplication and secret masking.
memory_export Export your complete verbatim history as Markdown in parts up to 100,000 characters.
memory_about Architecture, storage locations, and security guarantees (zero user data returned).

Account & Billing Tools (4)

Tool Purpose
account_status Current tier, permanent Arweave quota used/remaining this month, referral balance & link.
plans Live tier prices and storage allowances (zero user data returned).
buy_plan Creates a NOWPayments crypto invoice URL for your own account (nothing charged automatically).
request_payout Requests USDT (TRC20) withdrawal of referral earnings (checksum + OFAC sanctions screened).

Partner Program Tools (6)

Tool Purpose
partner_kit Commission rules, 14-day hold period, and outreach templates in en, ru, es, zh.
client_link Generates tracked partner links with optional service price and commission split.
client_report Generates an audit report page from published AIfa research data (passive data only).
find_clients Reserves up to 20 public research leads/day per region for 30 days.
my_deals Lists paid orders attributed to you and withdrawable commission dates.
set_webhook Registers an HMAC-signed https:// webhook for click & commission events.

Plans & Quotas

Plan Price Chat Quota (5h window) Document Storage Monthly Eternal Arweave Quota
Free $0 30 msgs / 5h (logged in) 50 MB (10 uploads / 5h) 0 MB (not anchored on-chain)
Spark $15 / mo 150 msgs / 5h 1 GB (30 uploads / 5h) 30 MB / mo
Family Archive $100 / mo 400 msgs / 5h 10 GB (100 uploads / 5h) 300 MB / mo
Digital DNA $1,000 setup + $200 / mo 1,500 msgs / 5h 50 GB (300 uploads / 5h) 1 GB / mo

Security, Isolation & Conformance Verification

  • Key-derived identity only: No tool accepts an email or user ID parameter — tenant scope comes strictly from the cryptographic Bearer key.
  • Data fencing & secret masking: Command-like text is blocked from memory storage; sensitive tokens written accidentally are redacted; retrieved records are fenced as untrusted data.
  • Scoped memory-only keys: Create via POST /api/account/mcp-token with {"scope": "memory"} when wiring agents that browse third-party web pages, preventing prompt-injected money/payout calls.
  • Per-record crypto-shredding: Paid Arweave backups encrypt every record with its own key so single-record deletion destroys only that record's key.
  • Independently verifiable live check (scripts/conformance.py):
export AIFA_MCP_KEY="your-full-key"
export AIFA_MCP_MEMORY_KEY="your-memory-only-key"
python scripts/conformance.py

See HOSTED-POLICY.md, SECURITY.md, and CHANGELOG.md for full operational transparency.

Local Engine & Agentic Shield (padam-nocturne)

Need 100% offline local-first memory (single SQLite file), PADAM Agentic Shield v2 (SRI/CSP/Magecart supply-chain CI scanner with SARIF 2.1.0, anti-poisoning, anti-replay HMAC, canary kill-switch, Slack/Teams/SIEM webhooks), or the desktop PADAM Studio UI?

License & Commercial Boundary

To keep developer documentation open while strictly protecting the hosted platform and intellectual property:

  1. Documentation & Examples (MIT License): The text documentation, server.json manifest, client config examples (examples/), and verification scripts in this repository are licensed under the MIT License.
  2. Hosted Cloud Platform (CODE Eternal Platform Terms): The hosted AIfa Memory service (https://aifa.works/api/mcp), backend databases, Digital Passports, Arweave/Solana eternal vaults (Spark / Family Archive / Digital DNA), and partner/freelance/digital-store commercial rails (15%–20% revenue share) are operated exclusively by CODE Eternal LLC (State of New Mexico, USA · Entity ID 0008138873) under aifa.works/terms and codeofdigitaleternity.com/code-terms-of-service-ethical-protection-statement. Open-source MIT access to these config examples does NOT grant rights to run, white-label, or resell the hosted service free of charge.
  3. Sole Founder & Ownership: Created and 100% solely owned by Maksim Galatin (Maksim Halatsin). External contributions do not transfer equity, ownership, or revenue share.

Links & Contact

MCP Server · Populars

MCP Server · New

    JollyToday

    Weydub Pro Subtitle Removal

    auto video translation-video translator can auto translate video hard subtitles, auto video translation and dubbing, remove any video text, auto remove video subtitles/text. 自动视频翻译配音,自动翻译视频字幕和回填样式,自动硬字幕翻译。

    Community JollyToday
    kitfunso

    Hippo

    One memory for every agent you'll ever use. Hippo writes what you teach a coding agent into a store in your repo, and your other agents read that same store.

    Community kitfunso
    Avazbek22

    DevProjex: MCP / GUI / CLI / TUI all in one

    Repomix alternative with up to 40% fewer tokens. Turn any codebase or Git repository into safe, token-efficient context for LLM and coding agents like Claude Code, Codex, and Cursor. GUI, TUI, CLI, and a read-only RAG MCP server with Live Context, agent journal, Smart Ignore, secret/PII redaction, and code compression. Windows, macOS, Linux.

    Community Avazbek22
    membaseai

    Membase

    Memory layer for AI agents — SDKs, CLI and MCP server for Membase

    Community membaseai
    dosco

    DeepORG — One AI Agent for Your Whole Organization

    DeepORG (formerly GraphJin) — one AI agent for your whole organization: databases, APIs, files, and code over MCP

    Community dosco