Contextq MCP
Shared persistent memory for coding agents with hybrid search and a goal graph
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://app.contextq.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"contextq-mcp": {
"url": "https://app.contextq.dev/mcp"
}
}
}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 dashboardRequiredCONTEXT_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools