Skip to content
MCP server

Contextq MCP

Shared persistent memory for coding agents with hybrid search and a goal graph

Install
Pricing
Freemium
Platforms
Web, API, CLI
Runs
Locally or Remotely
Version
2.1.1
Listing updated
1 day ago

About Contextq MCP

Contextq MCP is a freemium MCP server for knowledge and memory. It can run locally on your machine or as a hosted remote server.

ContextQ stores what agents learn so a later session, project or tool can find it. Search combines full-text and vector retrieval with rank fusion on Postgres, pgvector and Elasticsearch. A scheduled or manual dream pass uses an LLM to cluster related entries into a durable summary, archive the originals and record typed links such as supersedes, contradicts and derived_from.

The npm package exposes the API as 89 tools, but loads only a curated set of about 24 by default to keep the tool list small; the others load on demand through ctx_tool_groups and ctx_load_tool_group or with a full profile setting. Tools cover saving and searching entries, ingestion, goal graphs, agent sessions and relays. Examples in the site show ctx_save and ctx_search.

The server is a stateless proxy with a tenant-scoped API key sent as a bearer token and no telemetry of its own. It runs over stdio with npx or against a hosted remote endpoint, and needs an API URL and key. A free tier is mentioned for the dream feature, but plan details are not in the page text.

Install

Run in a terminal

claude mcp add --transport http contextq-mcp https://app.contextq.dev/mcp

Add to Settings → Connectors → Add custom connector

https://app.contextq.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "contextq-mcp": {
      "url": "https://app.contextq.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "contextq-mcp": {
      "type": "http",
      "url": "https://app.contextq.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "contextq-mcp": {
      "serverUrl": "https://app.contextq.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "contextq-mcp": {
      "type": "http",
      "url": "https://app.contextq.dev/mcp"
    }
  }
}

Configuration

  • CONTEXT_API_KEYContextQ API key (sk_live_...), created in the ContextQ dashboardRequired
  • CONTEXT_API_URLContextQ API base URL, https://app.contextq.dev for the hosted serviceRequired

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

ctx_save
Save an entry to memory
ctx_search
Hybrid search across stored memory
ctx_tool_groups
List available tool groups
ctx_load_tool_group
Load a tool group on demand

What it does

Hybrid retrieval
Full-text and vector search fused with reciprocal rank fusion.
Dream synthesis
LLM-assisted clustering writes summaries and archives originals.
Typed links
Supersedes, contradicts and derived_from record how entries relate.
Goal graph
Tools for goals, agent sessions and relays.
Tool profiles
About 24 tools by default, all 89 on request.
Tenant isolation
Each API key is bound to a single tenant.

Good for

  • Save a design decision once and recall it from any agent
  • Consolidate a week of scattered notes into summaries
  • Share project memory between Claude Code and Cursor
  • Track goals across agent sessions

Pricing

Freemium

A free tier exists; paid plan prices not shown

Prices change. Check contextq.dev before you buy.

Contextq MCP FAQ

How many tools are there?

89 in total, with a default set of about 24.

What does the server send?

Only the tool calls your agent makes, forwarded to your ContextQ API with no telemetry.

What is needed to run it?

CONTEXT_API_URL and CONTEXT_API_KEY.

Which clients are supported?

Claude Code, Claude Desktop, Cursor, Windsurf and Cline.

Is Contextq MCP free?

Contextq MCP has a free plan, with paid plans for more usage or features.

How do I add Contextq MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http contextq-mcp https://app.contextq.dev/mcp

What are the best alternatives to Contextq MCP?

The closest alternatives to Contextq MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Contextq MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools