# exec

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

## Usage

```bash
bdy integration exec [options] [command]
```

Use the integration's MCP server: list its tools, show one, call it, and manage executions

## 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 |
| `-h, --help` | display help for command |

## Available Commands

| **Command** | **Description** |
| :--- | :--- |
| [call](https://buddy.works/docs/cli/integration/exec/call.md) | Call a tool of the integration's MCP server Required scopes: INTEGRATION_USE |
| [kill](https://buddy.works/docs/cli/integration/exec/kill.md) | Cancel a running execution Required scopes: INTEGRATION_USE |
| [list](https://buddy.works/docs/cli/integration/exec/list.md) | List integration executions Required scopes: INTEGRATION_READ |
| [logs](https://buddy.works/docs/cli/integration/exec/logs.md) | Show execution logs Required scopes: INTEGRATION_READ |
| [status](https://buddy.works/docs/cli/integration/exec/status.md) | Show the status of an execution Required scopes: INTEGRATION_READ |
| [tool](https://buddy.works/docs/cli/integration/exec/tool.md) | Show a tool with its arguments (input schema) Required scopes: INTEGRATION_USE |
| [tools](https://buddy.works/docs/cli/integration/exec/tools.md) | List the tools of the integration's MCP server Required scopes:
  INTEGRATION_USE |

Documentation for bdy v1.25.34

## Examples

### List the tools of an integration's MCP server

```bash
bdy int exec tools integration-identifier
```

### Return the result as JSON

```bash
bdy integration exec tools integration-identifier --format json
```

### Show a tool and the arguments it takes

```bash
bdy int exec tool integration-identifier search_issues
```

### Get the full tool definition with its input schema

```bash
bdy int exec tool integration-identifier search_issues --format json
```

### 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