bdy integration exec call

View as Markdown

$bdy integration exec call [options] <integration> <tool>

Call a tool of the integration's MCP server Required scopes: INTEGRATION_USE

ARGUMENTS

integration

Integration identifier (required)

tool

Tool name (required)

OPTIONS

--context <name>

Connection and scope context: default, git, link or a saved name. Overrides the globally active context for this invocation.

--examples

Show only examples; with this flag --format accepts text, json or jsonl

--verbose

Show REST API requests, responses, timing and retries on stderr

-w, --workspace <domain>

Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE

-p, --project <name>

Project name. Can be set via variable: BUDDY_PROJECT

--scope <scope>

Force scope (WORKSPACE, PROJECT, ENVIRONMENT). By default calculated by provided options and environmental variables (--project, --environment, BUDDY_PROJECT, linked project)

--environment <identifier>

Environment identifier to scope the integration to. Resolves a workspace environment; add

--project

to point at a project environment

--args <json|@path|->

Tool arguments as a JSON object. To specify file use @path/to/file, - reads stdin. Default: {}

--no-validate

Skip checking the arguments against the tool's input schema before the call

-f, --force

Call a tool marked as destructive without confirmation

--async

Start the call and return the execution id without waiting for the result

--format <text|json>

Output format: json, text. JSON CLI errors: {error:{code,message,hint}}, exit 1. Default: text (choices: "text", "json")

-h, --help

display help for command

Documentation for bdy v1.25.34

Last modified on Nov 3, 2026

delete kill

Examples

Call a tool

bdy int exec call integration-identifier search_issues --args '{"query":"is:open","limit":10}'$

Call a tool with arguments from a file

bdy int exec call integration-identifier create_task --args @task.json$

Call a tool marked as destructive without confirmation

bdy int exec call integration-identifier delete_task --args '{"id":"123"}' -f$

Return the execution with the parsed result as JSON

bdy integration exec call integration-identifier search_issues --args '{"query":"bug"}' --format json$