Convex
by get-convex
Convex's official MCP server lets an agent inspect your schema, query and paginate data, run functions, and check deployment health from the CLI.
Start the MCP server
npx -y convex@latest mcp start
About
The Convex MCP server, started with npx convex mcp start, gives an AI assistant a structured window into a Convex deployment: list tables with their schemas, page through documents, run a one-off read-only JavaScript query, inspect deployed function metadata, invoke a function, and pull recent execution logs. An insights tool reports 72 hours of health metrics, including OCC (optimistic concurrency control) conflicts and resource-limit issues that flag a struggling function before it becomes an incident.
It's deliberately conservative about production by default: write-capable and destructive operations are blocked unless you explicitly opt in, and production deployments only ever get read-only, non-PII access unless you pass --dangerously-enable-production-deployments. You can also scope an agent to one specific deployment with a deploy key, which matters once you're running this against anything beyond your own local dev environment.
Key features
- Lists tables with schemas and pages through documents without writing a query by hand
- Runs one-off read-only JavaScript queries against live data
- Invokes deployed functions and returns their execution logs
- 72-hour health insights covering OCC conflicts and resource-limit warnings
- Manages deployment environment variables (list, get, set, remove)
- Production access is read-only and non-PII by default, opt-in for anything more
Use cases
- Letting an agent debug why a function is failing by reading its logs and recent OCC conflicts
- Asking an assistant to page through a table's data without writing manual query code
- Auditing environment variables across a deployment from inside an editor
- Scoping an agent to a single deployment via a deploy key for safer automation
Available tools
status
Reports the deployments available for the agent to work with.
tables
Lists tables in the deployment along with their schemas.
data
Pages through documents in a table.
runOneoffQuery
Executes a read-only JavaScript query against the deployment.
run
Invokes a deployed Convex function.
insights
Reports 72 hours of health metrics, including OCC conflicts and resource-limit issues.
Frequently asked questions
Can an agent write to my production database by accident?
By default, production deployments are limited to read-only, non-PII operations; write access requires an explicit opt-in flag.
Do I need to set anything up for Claude Code specifically?
Convex provides a Claude Code plugin that starts the MCP server for you automatically, on top of the manual npx command.