Convex MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Convex MCP or direct API to query database records, run serverless functions, inspect app data, and manage backend workflows through natural language.

Convex logoConvex
Api KeyBearer Token

Convex is a Backend-as-a-Service platform with a real-time database, serverless functions, and built-in authentication. Use it to build reactive apps faster without managing backend infrastructure.

19 Tools

Try Convex now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Convex
Try asking
TOOLS

Supported Tools

Every Convex action and event your agent gets out of the box.

Create deploy key

Tool to create a deploy key for use with the Convex CLI.

Create Deployment

Tool to create a new deployment for a Convex project.

Create Project

Tool to create a new project on a Convex team, optionally provisioning a dev or prod deployment.

Delete Custom Domain

Tool to remove a custom domain from a Convex deployment.

Delete Deployment

Tool to delete a Convex deployment.

Delete project

Deletes a Convex project and all its deployments permanently.

Execute Query Batch

Tool to execute multiple Convex query functions in a single batch request.

Get Deployment Details

Tool to retrieve details about a Convex cloud deployment.

Get Project by ID

Tool to retrieve detailed information about a specific Convex project by its ID.

Get Project by Slug

Tool to retrieve a Convex project by its slug within a team.

Get Query Timestamp

Tool to get the latest timestamp for queries from Convex deployment.

Get token details

Tool to retrieve token details for the authenticated token.

List Deploy Keys

Tool to list all deploy keys for a specified Convex deployment.

List deployment classes

Tool to list available deployment classes for a Convex team.

List deployment regions

Tool to list available deployment regions for a Convex team.

List Deployments

Tool to list all deployments for a Convex project.

List Log Streams

Tool to list all existing log stream configurations in a deployment.

List Projects

Tool to list all projects for a specific Convex team.

Update Deployment

Tool to update properties of an existing Convex deployment.

SETUP GUIDE

Connect Convex MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Convex
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'List records from my Convex tasks table and summarize the open tasks'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Convex API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Convex Tools via Tool Router with Your Agent

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');

const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List records from my Convex tasks table and summarize the open tasks'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Convex actions with your Agent

Why Use Composio?

AI Native Convex Integration

  • Supports both Convex MCP and direct API based integrations
  • Structured, LLM-friendly schemas so agents can safely query Convex data and call functions
  • Use mcp.create() when you want a dedicated Convex MCP server for tools like Claude, Cursor, or custom agents

Managed Auth

  • Store Convex API keys and bearer tokens securely instead of hard-coding them in agent code
  • Create Convex auth configs with auth_configs.create(), then connect users with connected_accounts.link()
  • Manage per user and per environment Convex credentials from one place

Agent Optimized Design

  • Tools are shaped for language models, so agents know when to read data, call a query, or run a mutation
  • Comprehensive execution logs help you see what ran, when it ran, and which Convex account was used
  • Less glue code. Less guesswork. Your agent gets clean tools it can actually use.

Enterprise Grade Security

  • Fine-grained access controls help you decide which agents and users can reach Convex
  • Scoped, least privilege access for Convex projects, deployments, and backend actions
  • Full audit trails make it easier to review agent activity and meet compliance needs
FAQ

Frequently asked questions

Yes, Convex requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Convex.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Convex tool your agent needs.Free to start.

Start building