mirror of
https://github.com/actionbook/actionbook.git
synced 2026-09-19 03:28:06 +08:00
50 lines
1.2 KiB
Plaintext
50 lines
1.2 KiB
Plaintext
---
|
|
title: 'MCP Tools Reference'
|
|
description: '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
|