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)
- Sign in at aifa.works/mcp and generate your personal API key (choose Memory-Only when attaching untrusted or web-browsing agents).
- Copy the configuration snippet for your client below and replace
YOUR_AIFA_MCP_KEY. - 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-tokenwith{"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?
- Local Engine & Studio (
AGPL-3.0-only+ Commercial):MaksimGalatin/padam-nocturne - GitHub Organization:
CodeOfDigitalEternity - Enterprise Commercial Licensing / Mutual NDA / Zero-Telemetry DPA:
[email protected]
License & Commercial Boundary
To keep developer documentation open while strictly protecting the hosted platform and intellectual property:
- Documentation & Examples (
MIT License): The text documentation,server.jsonmanifest, client config examples (examples/), and verification scripts in this repository are licensed under the MIT License. - 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 ID0008138873) 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. - 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
- Create MCP Key: aifa.works/mcp
- Partner Program: aifa.works/partners
- Organization Profile: github.com/CodeOfDigitalEternity
- Support, Security & Enterprise Licensing:
[email protected]·[email protected]