CConvex MCP (official)

Tested npm convex 1.49.0 (Apache-2.0 per npm; repo convex/convex-backend, npm-packages/convex, 12,788 GitHub stars when checked) through `convex mcp start`, the command Convex's docs give. Initialize and tools/list worked (12 tools for deployment status, tables, data, function specs, logs, env vars, running functions and queries). The one read call, status on an empty project dir, answered 'Not Authorized: Run npx convex dev to login'; every tool needs a Convex login and project, which we don't do. Core tools not tested. run, runOneoffQuery and the envSet/envRemove tools were not called.
Tool-call test (2026-11-11, direct MCP stdio client, no LLM): fail. 0 of 1 read call passed; every tool needs a Convex login and project. Core tools not tested. Evidence: local test run, Nov 11, 2026.

Transport (tested 2026-11-11): stdio

Score 70/100 · Tools 12 · Token cost approx. 2,234 tokens · Compare · Last tested 2026-11-11 · Version tested 1.49.0 · Package convex · Repo convex/convex-backend

Summary: Convex MCP (official) completed an MCP handshake without credentials and exposed 12 tools.

Evidence summary

Handshake

pass

Tools listed

12

Context cost

approx. 2234 tokens, cl100k estimate (12 tools, measured 2026-11-11, version 1.49.0; an estimate) ranking · add up your servers' context cost

API key

Connects without a key; tool calls need one

Tested

2026-11-11

Test results

Local-model readiness

Token cost (estimate): approx. 2234 tokens, cl100k estimate for 12 tools · about 27% of an 8k context. This is an estimate from our testing (counted with cl100k_base).

Small-model friendly (schema heuristic, not a model result): unknown.

What we tested and what we didn't

Methodology: how we test. A high score means it installs and responds, not that giving it access to your data carries no risk.

{
  "name": "convex",
  "version": "1.49.0",
  "registry": "npm",
  "status": "working",
  "tested": "2026-11-11",
  "tools_count": 12,
  "deprecated": false,
  "archived": false,
  "tests": {
    "install": [
      "pass",
      20,
      "`npm install convex` (Node 20, Linux) succeeded in 1s."
    ],
    "handshake": [
      "pass",
      30,
      "MCP `initialize` + `tools/list` over stdio succeeded with no credentials; 12 tools listed in 2.3s."
    ],
    "maintenance": [
      "pass",
      25,
      "Repo pushed 0 days before test; 12,788 GitHub stars."
    ],
    "docs": [
      "fail",
      0,
      "README checks failed. Check of the package's own README (README shipped in npm package)."
    ],
    "license": [
      "pass",
      10,
      "Apache-2.0 (OSI-approved)."
    ]
  }
}

Install

npx -y convex mcp startCopy

Pin the version we tested

npx -y convex@1.49.0 mcp startCopy

tested 2026-11-11. Newer versions may differ and were not tested by us.

{
  "mcpServers": {
    "convex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "convex@1.49.0",
        "mcp",
        "start"
      ]
    }
  }
}

Tools listed

data, envGet, envList, envRemove, envSet, functionSpec, insights, logs, run, runOneoffQuery, status, tables

Tool history: captured Nov 11, 2026. All tool history.

Quick config

{
  "mcpServers": {
    "convex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "convex",
        "mcp",
        "start"
      ]
    }
  }
}

Add to config Opens the config generator with this server selected.

{
  "mcpServers": {
    "convex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "convex",
        "mcp",
        "start"
      ]
    }
  }
}

Related: Best database MCP servers

FAQ

Is Convex MCP deprecated?

No. convex was not deprecated or archived when we last tested it on 2026-11-11.

What replaces Convex MCP?

Nothing; Convex MCP (official) is not deprecated as of 2026-11-11.

Does Convex MCP need an API key?

It connects and lists 12 tools without a key, but its tool calls need one.

Embed the badge

Every tested server gets a free embeddable badge. It shows the current score and test date and expires after 90 days. Testing is free; payment never changes a score.

Copy HTML

Copy Markdown Claim this listing · Report an issue