Quickstart

Get started with MemQ

Install, save one decision, restart the agent session, and recall it. That is the first validation that your AI workflow has stopped resetting.


Memory that carries work forward

Most memory tools store notes. MemQ turns memory into a living system: it writes, searches, reflects, links ideas, protects namespaces, and routes different memory jobs through the right inference path.

How MemQ routes memory work

Fast path — validation, formatting, lightweight summaries, and health checks.

Recall path — semantic search, recent memory, and namespace-aware retrieval.

Reflection path — distillation, contradiction repair, pattern extraction, and durable memory consolidation.

High-trust path — billing, policy, admin, and access-sensitive work that fails closed.

Prompts cannot upgrade themselves. Your Billing Dashboard plan and API key decide access before memory or AI usage is allowed.


Choose a starter repo

Use a starter when you want a working save-to-recall loop instead of a blank config file. Each starter keeps secrets in MEMQ_API_KEYand includes a smoke path for save -> fresh request -> recall.

memq-mcp-starter

Minimal MCP memory setup with a save, restart, and recall continuity test.

GitHub repo · local starter files

memq-team-handoff-starter

Team namespace handoff flow for developer teams that need shared agent context.

GitHub repo · local starter files

memq-cursor-claude-starter

Editor-focused setup for Cursor, Claude, VS Code, and Antigravity.

GitHub repo · local starter files

memq-n8n-agent-starter

Workflow-agent memory example for n8n MCP Client and MCP Client Tool nodes.

GitHub repo · local starter files


Agent discovery path

Modern agents do not have to start from a pasted tutorial. The homepage and MemQ page advertise discovery links, and the well-known metadata below points agents to Billing Manager auth, the MemQ MCP server card, OpenAPI descriptions, docs, and status.

API catalog

RFC 9727 linkset that advertises MemQ, site APIs, docs, status, OpenAPI descriptions, and MCP metadata.

https://multinex.ai/.well-known/api-catalog

OAuth authorization server

OAuth discovery metadata mirrored for agents that need the Billing Manager authorization and token endpoints.

https://multinex.ai/.well-known/oauth-authorization-server

OAuth protected resource

RFC 9728 metadata telling agents that MemQ tokens are issued by Billing Manager and which scopes are supported.

https://multinex.ai/.well-known/oauth-protected-resource

MCP server card

Machine-readable MemQ MCP endpoint, transport, auth, and capability summary for agent discovery.

https://multinex.ai/.well-known/mcp/server-card.json

Agent-ready checks
# Discover public API and MCP metadata
curl -I https://multinex.ai/
curl -L https://multinex.ai/.well-known/api-catalog
curl -L https://multinex.ai/.well-known/oauth-protected-resource
curl -L https://multinex.ai/.well-known/mcp/server-card.json

# MemQ still connects through the hosted MCP endpoint
curl -I https://mcp.multinex.ai/mcp/v1

Prerequisites

  • A Multinex account with a MemQ API key create one in Billing Manager
  • An MCP-capable editor — Claude, Cursor, VS Code, Claude Desktop, or Antigravity

1. Add the API-key MCP config

Paste this into your editor's MCP configuration file and keep MEMQ_API_KEY in your local environment or secret store. For detailed per-editor instructions, see the editor setup guide. Agent-capable clients may also discover the same endpoint from the MCP server card or from the API catalog.

MCP Config (API key)
{
  "mcpServers": {
    "memq": {
      "type": "http",
      "url": "https://mcp.multinex.ai/mcp/v1",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer $MEMQ_API_KEY"
      }
    }
  }
}

Config file locations

Claude Code~/.claude/mcp.json

Cursor~/.cursor/mcp.json

VS Code.vscode/mcp.json

Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json

Antigravity — Settings → MCP Servers


Copy-paste MCP snippets

These snippets cover the primary developer surfaces. Keep the API key in your environment or secret manager; do not paste raw keys into config files.

Claude Desktop / Claude Code - ~/.claude/mcp.json or claude_desktop_config.json
{
  "mcpServers": {
    "memq": {
      "type": "http",
      "url": "https://mcp.multinex.ai/mcp/v1",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer $MEMQ_API_KEY"
      }
    }
  }
}
Cursor - ~/.cursor/mcp.json
{
  "mcpServers": {
    "memq": {
      "type": "http",
      "url": "https://mcp.multinex.ai/mcp/v1",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer $MEMQ_API_KEY"
      }
    }
  }
}
VS Code - .vscode/mcp.json
{
  "mcp": {
    "servers": {
      "memq": {
        "type": "http",
        "url": "https://mcp.multinex.ai/mcp/v1",
        "transport": "streamable-http",
        "headers": {
          "Authorization": "Bearer $MEMQ_API_KEY"
        }
      }
    }
  }
}
Antigravity / Gemini-style - .gemini/mcp.json or Antigravity MCP settings
{
  "mcpServers": {
    "memq": {
      "type": "http",
      "url": "https://mcp.multinex.ai/mcp/v1",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer $MEMQ_API_KEY"
      }
    }
  }
}
n8n MCP Client - MCP Client node credentials
{
  "serverUrl": "https://mcp.multinex.ai/mcp/v1",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer $MEMQ_API_KEY"
  }
}
Generic Streamable HTTP MCP - Client-specific MCP server registry
{
  "name": "memq",
  "type": "http",
  "url": "https://mcp.multinex.ai/mcp/v1",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer $MEMQ_API_KEY"
  }
}

2. Restart and connect

Restart your editor after saving the config. MemQ uses the API key to activate the right plan, namespace access, AI call meters, memory read/write limits, and tool activity visibility.


3. Verify the connection

After approval, your AI auto-discovers all 35 memory tools. Run this verification sequence to confirm everything works:

First-call verification
# 1. Session handshake — confirms auth + namespace
reunion

# 2. Check your namespace and access tier
namespace_info

# 3. Write a test journal entry
journal_record  (content: "First MemQ connection verified")

# 4. Search for it
journal_search  (query: "first connection")

# 5. Pack context for the current session
mnemosyne_context

If all five calls return successfully, you're connected and your AI has persistent memory.


First useful memories

After the test entry works, add one real memory. This gives your agent immediate value and proves the loop before you depend on it.

Good first entries

Coding agent - "This repo prefers strict TypeScript, Zod at IO boundaries, and buyer-readable benchmark claims."

Research agent - "When comparing memory systems, separate managed-cloud claims from OSS adapter benchmarks."

Team runbook - "For billing usage issues, check reads, writes, segments, source, and last recorded usage event."


Next steps

Tool Reference — Learn what all 35 tools do and when to use them
Editor Setup — Install extensions, Claude plugins, and munx-cli
Teams & Namespaces — Set up shared team memory