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
- Find the action in the table below, or call
search_one_platform_actions with platform convex-management if it is not listed.
- 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.
- 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.
withoneai