convex-mcp

Query Convex databases via the Convex MCP server for schema and data inspection.

Updated Dec 2, 2025
One-click install
npx skills add https://github.com/matixlol/monitoreo-panama --skill convex-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-mcp
Source: https://github.com/matixlol/monitoreo-panama/tree/main/.agents/skills/convex-mcp
Command: npx skills add https://github.com/matixlol/monitoreo-panama --skill convex-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Convex MCP interface helps you interact with the Convex database to check data, view table schemas, browse documents, and run read-only or deployed function queries.

Core Features & Use Cases

  • Explore deployment status to identify the current environment and deployment selector.
  • List tables and their schemas to understand data structures and relationships.
  • Browse and paginate through documents within a table using data.
  • RunOneoffQuery for read-only JavaScript queries and inspect results.
  • Use the functionSpec, run, and logs tooling to inspect deployed functions and their execution traces.

Quick Start

Launch the MCP server and connect to your deployment. Then run status to get the selector, tables to inspect schema, data to browse documents, and runOneoffQuery to execute read-only queries.

Frequently Asked Questions about convex-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query data from a Convex database using MCP?

You can query Convex database data using MCP by connecting to the server and utilizing tools like runOneoffQuery to execute read-only JavaScript queries and inspect the returned results directly.

Can I browse table schemas and documents in a Convex deployment?

Yes, you can browse table schemas and documents in a Convex deployment by using the tables tool to inspect data structures and the data tool to paginate through documents.

Does the Convex MCP server support inspecting deployed functions?

Yes, the Convex MCP server supports inspecting deployed functions by exposing the functionSpec tool to view specifications and the logs tool to inspect execution traces.

What is the best way to check the status of a Convex deployment?

The best way to check the status of a Convex deployment is to use the status tool within the MCP workflow to identify the current environment and deployment selector.

Are there limitations when running read-only queries against Convex tables?

The primary limitation is that query tools like runOneoffQuery are restricted to read-only JavaScript queries, preventing data mutation while browsing documents or inspecting schemas.