Ask your agent in plain language. Each of these maps to a real tool on the server.
run_mutation
Execute a Convex mutation function over HTTP. Mutations are write operations that can read and modify data in the Convex database with ACID transaction guarantees. Specify the function path (e.g. `messages:send` or `users:create`) and optional arguments. Returns the mutation result.
generate_upload_url
Generate a temporary upload URL for uploading a file to Convex file storage. The returned URL can be used to POST file content directly. After uploading, a storage ID is returned that can be referenced in documents. Requires a deployed mutation that returns ctx.storage.generateUploadUrl().
get_document_deltas
Retrieve incremental document changes (inserts, updates, deletes) from a Convex deployment using the Streaming Export API. Returns a cursor-based change feed of document-level modifications since a given cursor position. Useful for syncing external systems, building audit trails, or tracking data changes over time. Requires deployment administration permission and Streaming Export availability on your plan.
run_query
Execute a Convex query function over HTTP. Queries are read-only functions that fetch data from the Convex database. Specify the function path (e.g. `messages:list` or `users:getById`) and optional arguments. Returns the query result as JSON.
list_documents
List documents from a Convex table using the Streaming Export API snapshot endpoint. Retrieves a paginated snapshot of documents from a specific table or across all tables. Useful for browsing data, exporting records, or inspecting table contents. Requires deployment administration permission and Streaming Export availability on your plan.
run_action
Execute a Convex action function over HTTP. Actions can call external APIs, use third-party libraries, and perform side effects that are not possible in queries or mutations. Specify the function path (e.g. `ai:generateEmbedding` or `email:send`) and optional arguments. Returns the action result.
manage_environment_variables
View or update environment variables for a Convex deployment. When no changes are provided, lists all current environment variables. When changes are provided, updates the specified environment variables; omit a change's value to delete that variable. Listing includes secret values. Requires deployment environment-variable permission.
get_deployment_info
Identify the configured Convex deployment, including its project, team and deployment type when hosted in Convex Cloud.
download_file
Download a Convex storage file using a deployed query that returns ctx.storage.getUrl(storageId). The query controls access to the file.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.
Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.
Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.
Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.
Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.
Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.
Invoke serverless queries, mutations, and actions on a reactive document-relational database. Read, insert, update, and delete documents across tables with ACID transactions. Upload and manage files in built-in storage. Schedule functions for future or recurring execution (cron jobs). Perform full-text search with BM25 relevance scoring and vector similarity search for AI/RAG use cases. Stream export document-level changes (inserts, updates, deletes) for incremental data sync to external systems. Stream import data from external sources into Convex tables. Manage projects, deployments, deploy keys, and environment variables via the Management API. Define custom HTTP endpoints for inbound webhooks and REST-style APIs.
Common questions about connecting Convex to AI agents with Metorial.
