convex-management

name

convex-management

description

Convex Management provides a developer console for managing applications built on the Convex backend platform, including database data, serverless functions, deployments, logs, and configuration, helping teams monitor, operate, and scale real-time applications from a centralized interface. Read and write Convex Management data through One: deployments, projects, deploykey, teamproject, projectdeployment, deploymentclasses and more, 20 actions with real parameter documentation. Use whenever the user asks to look something up in Convex Management, create or update a record there, or build code against the Convex Management API.

Convex Management through One

Convex Management provides a developer console for managing applications built on the Convex backend platform, including database data, serverless functions, deployments, logs, and configuration, helping teams monitor, operate, and scale real-time applications from a centralized interface.

One exposes Convex Management through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform convex-management if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Convex Management is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Convex Management account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Deployments

Action	Method	Path	Action id
Get a Deployment	GET	/deployments/{{DEPLOYMENT_NAME}}	conn_mod_def::GJj9jKe8ihs::K8WdOzgqTjWCtRGtHQg1IQ
List a Project’s Deployments	GET	/projects/{{PROJECT_ID}}/list_deployments	conn_mod_def::GJj9iYmynbw::wl2zkUx4R1mFZLMQ9R8-Ew
Delete a Deployment	POST	/deployments/{{DEPLOYMENT_NAME}}/delete	conn_mod_def::GJj9jEHxxSA::1rM03XibTwiC_EihkDAfIQ
Delete a Deployment's Custom Domain	POST	/deployments/{{DEPLOYMENT_NAME}}/delete_custom_domain	conn_mod_def::GJj9kITJIG8::I1yeqWs5QiqYhNEqPZ4mqA
Update a Deployment's Settings	PATCH	/deployments/{{DEPLOYMENT_NAME}}	conn_mod_def::GJj9jQbiL3c::Hke8RHCUQ0Oe-HJ8yXYyPQ

Projects

Action	Method	Path	Action id
Get a Project by ID	GET	/projects/{{PROJECT_ID}}	conn_mod_def::GJj9inTMA4U::XDV6wTuiSXiIcKPKD5EWTw
Get a Team's Project by Slug	GET	/teams/{{TEAM_ID_OR_SLUG}}/projects/{{PROJECT_SLUG}}	conn_mod_def::GJj9izsGNa4::1GrNf2byRiKotQhbIjPRMg
List a Team’s Projects	GET	/teams/{{TEAM_ID}}/list_projects	conn_mod_def::GJj9iOAs5Ig::DxaMoNriQIOydppPFJhc2w
Delete a Project	POST	/projects/{{PROJECT_ID}}/delete	conn_mod_def::GJj9ihFLJiI::JVry-hJoTJO-gufHHQg6Zw

DeployKey

Action	Method	Path	Action id
Create a Deployment Deploy Key	POST	/deployments/{{DEPLOYMENT_NAME}}/create_deploy_key	conn_mod_def::GJj9jlTBFvU::Yd8mlDR1TsOIyPUNMXv9yg
Delete a Deployment's Deploy Key	POST	/deployments/{{DEPLOYMENT_NAME}}/delete_deploy_key	conn_mod_def::GJj9jzFjhHg::CHHBEX9KRP-Z76tTx3rLsg

TeamProject

Action	Method	Path	Action id
Create a Team Project	POST	/teams/{{TEAM_ID}}/create_project	conn_mod_def::GJj9iHYlo48::2X9QDW__TcKBXVQa5kUCvA

ProjectDeployment

Action	Method	Path	Action id
Create a Project Deployment	POST	/projects/{{PROJECT_ID}}/create_deployment	conn_mod_def::GJj9i7kzIO0::yPWYy14lSxirjf_kvdZo3Q

DeploymentClasses

Action	Method	Path	Action id
List a Team's Deployment Classes	GET	/teams/{{TEAM_ID}}/list_deployment_classes	conn_mod_def::GJj9jWIJESg::jNO3aPH0Su-fO5Qg-joLzA

DeploymentRegions

Action	Method	Path	Action id
List a Team's Deployment Regions	GET	/teams/{{TEAM_ID}}/list_deployment_regions	conn_mod_def::GJj9jfTX1DU::VsdzhHKDTuGWxqP84tquwg

DeployKeys

Action	Method	Path	Action id
List a Deployment's Deploy Keys	GET	/deployments/{{DEPLOYMENT_NAME}}/list_deploy_keys	conn_mod_def::GJj9jsQSW5o::MrSdoc74Ro2z0L0OyM7clw

TokenDetails

Action	Method	Path	Action id
Get Token Details	GET	/token_details	conn_mod_def::GJj9j5gzJ9k::kmM3yzYrR4We4SF0oCofnQ

DeploymentCustomDomain

Action	Method	Path	Action id
Create a Deployment's Custom Domain	POST	/deployments/{{DEPLOYMENT_NAME}}/create_custom_domain	conn_mod_def::GJj9kArnYTQ::Yhly4pTtQb6nuzxipvDV4A

TeamMembers

Action	Method	Path	Action id
List a Team’s Members	GET	/teams/{{TEAM_ID}}/list_members	conn_mod_def::GJj9kcQUEtk::9GPs3TvDSc21LHQFTzg_6A

CustomDomains

Action	Method	Path	Action id
List a Deployment's Custom Domains	GET	/deployments/{{DEPLOYMENT_NAME}}/custom_domains	conn_mod_def::GJj9kO-hUj8::Vp6oKSiPTmuQ6Pg4zg0UmQ

When a call fails

The error comes from Convex Management, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/convex-management

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.