> ## Documentation Index
> Fetch the complete documentation index at: https://actionbook.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tools Reference

> Reference for Actionbook MCP Tools

# MCP Tools Reference

<Note>
  Most users should start with the [CLI](/guides/installation). This page covers
  the MCP protocol internals — useful if you're building custom integrations or
  debugging tool calls.
</Note>

## MCP Tools

Actionbook exposes the following tools through the MCP protocol:

### search\_actions

Search for actions by keyword.

**Parameters:**

* `query` (string): Search keyword

**Returns:** List of matching actions with metadata

### get\_action\_by\_id

Get action content by ActionId.

**Parameters:**

* `actionId` (string): The ActionId in format `site/{domain}/page/{pageType}/element/{semanticId}`

**Returns:** Action content including selectors and methods

## Domain Model

```
Site -> Page -> Element -> ElementAction
                       \-> Scenario -> ScenarioStep
```

* **Site**: Website domain with metadata
* **Page**: Functional page type with URL patterns
* **Element**: Interactive UI element with semantic ID
* **ElementAction**: Selectors (css, xpath, ariaLabel, dataTestId) and allowed methods
* **Scenario**: Complete user operation flow