# Contextq MCP

> Contextq MCP is a freemium MCP server for knowledge and memory. Shared persistent memory for coding agents with hybrid search and a goal graph. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI, self-hosted
- **Website:** https://contextq.dev
- **Repository:** https://github.com/contextq/contextq-mcp
- **MCP Registry name:** io.github.contextq/contextq-mcp
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.contextq.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "contextq-mcp": {
      "url": "https://app.contextq.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/contextq-mcp
