BellD / DevelopersDocumentation · latest

MCP tools

Source: cli/src/mcp/tools.ts

Start the local stdio gateway with belld mcp. The closed tool list below is extracted from the repository.

belld_whoami

Read the authenticated workspace membership.

Read · belld whoami

belld_workspace_list

List accessible workspaces.

Read · belld workspace list

belld_product_list

List products with cursor pagination.

Read · belld product list

belld_product_get

Read one product.

Read · belld product get

belld_product_create

Import a repository by URL and ref. Polls source freeze to a terminal state; default timeout 600 seconds.

Write · belld product create

belld_revision_list

List revisions, optionally filtered by product.

Read · belld revision list

belld_revision_get

Read one revision and its evaluation summaries.

Read · belld revision get

belld_revision_confirm

Confirm the detected descriptor for a product revision. Optional edits override detected fields; omit edits to confirm as detected.

Write · belld revision confirm

belld_evaluate

Evaluate qualification and poll to a terminal state; default timeout 600 seconds. Inspect qualification.status before creating a release.

Write · belld evaluate

belld_pipeline_run_get

Read one pipeline run and its findings.

Read · belld pipeline-run get

belld_release_create

Create a staged release. Provide exactly one of version_id or revision_id; a revision must resolve to exactly one version.

Write · belld release create

belld_deploy

Submit a release deployment to staging; returns acceptance and the deployment query location.

Write · belld deploy

belld_deployment_get

Read one deployment once; does not poll.

Read · belld deployment get

belld_surface_get

Read one surface once; does not poll.

Read · belld surface get

belld_usage

List capability usage, optionally filtered by product and outcome.

Read · belld usage

belld_budget_list

Read current monthly usage budgets.

Read · belld budget list

belld_binding_list

List provider binding metadata with cursor pagination.

Read · belld binding list

belld_context

Read the local project context snapshot (manifest, imports, env variable names, routes, git state) and the linked BellD state. Env values are not returned.

Read · belld context

belld_requirements

Detect BellD requirements from local project evidence: class, target, action, confidence and evidence per item. Local only; no API calls.

Read · belld requirements

belld_explain

Explain a pipeline run, revision, deployment, binding or capability invocation from recorded evidence. Facts and inference are separate.

Read · belld explain

belld_status

Read product status: workspace, product, latest revision, deployments, bindings, wallet and budgets.

Read · belld status

belld_doctor

Run readiness checks. Failing checks are returned as data with a next step, not as tool errors.

Read · belld doctor

belld_binding_status

Compare the revision capability contract with provider bindings (one page) and count bindings per capability.

Read · belld binding status

belld_capabilities

List the offline capability catalog: id, actions and scope.

Read · belld capabilities

belld_explain_deployment

Explain one deployment: the deployment, its explanation and its surface when present.

Read · belld explain-deployment

belld_product_readiness

Assess product readiness from readiness checks, wallet and budgets: a verdict and blocking items.

Read · belld product readiness

belld_next_step

Return the next step from readiness checks; failing checks come before warnings.

Read · belld next-step

belld_variables_list

List variables for an App or a service/Product. Secrets are write-only and secret values are returned as null when listing.

Read · belld variables list

belld_variables_set

Set a variable for an App or a service/Product. Secrets are write-only and secret values are returned as null when listing.

Write · belld variables set

belld_variables_unset

Unset a variable for an App or a service/Product. Secrets are write-only and secret values are returned as null when listing.

Write · belld variables unset