# call

> For AI agents: the complete documentation index is at https://buddy.works/llms.txt

## Usage

```bash
bdy integration exec call [options] <integration> <tool>
```

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

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `integration` | Integration identifier (required) |
| `tool` | Tool name (required) |

## Options

| **Option** | **Description** |
| :--- | :--- |
| `--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

## Examples

### Call a tool

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

### Call a tool with arguments from a file

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

### Call a tool marked as destructive without confirmation

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

### Return the execution with the parsed result as JSON

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


---
Original source: https://buddy.works/docs/cli/integration/exec/call