> ## Documentation Index
> Fetch the complete documentation index at: https://piyushvyas.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# MCP Tools Reference
> Complete reference for all 23+ MCP tools exposed by the BAP MCP server.
# MCP Tools Reference
The BAP MCP server exposes 23 tools organized into six categories. With `--slim` mode, only 5 essential tools are exposed.
## Navigation
Navigate to a URL. Supports fused observation via the `observe` parameter.
The URL to navigate to.
When to consider navigation complete: `load`, `domcontentloaded`, `networkidle`.
Fuse observation with navigation. Returns page elements alongside the navigation result.
Maximum number of elements to return.
Response tier: `full`, `interactive`, `minimal`.
```
navigate({ url: "https://example.com", observe: { maxElements: 20 } })
```
Navigate back in browser history.
No parameters.
Navigate forward in browser history.
No parameters.
Reload the current page.
No parameters.
## Element Interaction
Click an element using semantic selectors.
Element selector (see [Selector Formats](#selector-formats) below).
Fill a form field. Clears existing content first.
Element selector targeting the input field.
The value to fill.
Type text character by character. First clicks the element, then types. Triggers individual key events.
Element selector.
Text to type character by character.
Delay in milliseconds between keystrokes.
Press keyboard keys (Enter, Tab, shortcuts).
Key to press (e.g., `Enter`, `Tab`, `Escape`, `Control+a`).
Optional element to focus before pressing.
Select an option from a dropdown.
Element selector targeting the `
Option value or visible text to select.
Scroll the page or a specific element.
Scroll direction: `up`, `down`, `left`, `right`.
Pixels to scroll.
Optional element to scroll into view.
Hover over an element.
Element selector.
## Observation
AI-optimized page observation. Returns interactive elements with stable refs. Supports incremental diffs and response tiers.
Maximum elements to return.
Filter by ARIA roles (e.g., `["button", "link", "textbox"]`).
Include an annotated screenshot with element refs.
Return only changes since the last observation: `{ added, updated, removed }`.
Response tier: `full`, `interactive`, `minimal`.
Include tools discovered via the WebMCP standard.
```
observe({ maxElements: 20, responseTier: "interactive", includeScreenshot: true })
```
Take a screenshot of the current page.
Capture the entire scrollable page.
Token-efficient YAML accessibility snapshot. Approximately 80% fewer tokens than `accessibility`.
No parameters.
Prefer `aria_snapshot` over `accessibility` for cost efficiency. Same structure, far fewer tokens.
Full accessibility tree.
No parameters.
Get page text content.
Output format: `text` or `markdown`.
Query element properties: exists, visible, enabled, checked, value.
Element selector.
## AI Agent Methods
Execute a sequence of browser actions in a single call. Supports fused pre/post observation.
Array of action steps. Each step has `action`, `selector`, and optionally `value`.
```
steps: [
{ action: "action/fill", selector: "label:Email", value: "user@example.com" },
{ action: "action/click", selector: "role:button:Submit" }
]
```
Observe page state before executing steps.
Observe page state after executing steps. Contains `maxElements`, `responseTier`.
```
act({
steps: [
{ action: "action/fill", selector: "@e1", value: "user@example.com" },
{ action: "action/fill", selector: "@e2", value: "password123" },
{ action: "action/click", selector: "role:button:Sign in" }
],
postObserve: { responseTier: "interactive" }
})
```
Extract structured data from the page using schema and CSS heuristics.
Natural language description of what to extract.
Extraction mode: `single` (one object) or `list` (array of objects).
JSON Schema defining the extraction shape.
```
extract({
instruction: "Extract product listings",
mode: "list",
schema: {
type: "array",
items: {
type: "object",
properties: {
name: { type: "string" },
price: { type: "number" }
}
}
}
})
```
## Page Management
List all open pages/tabs.
No parameters.
Switch to a different page/tab.
Page ID from the `pages` result.
Close the current page/tab.
No parameters.
## Discovery
Discover tools that websites expose via the W3C WebMCP standard. Checks for declarative (form-based) and imperative (navigator.modelContext) tool definitions.
No parameters.
## Selector Formats
All tools that accept a `selector` parameter support these formats:
```
role:button:Submit # ARIA role + accessible name (recommended)
text:Sign in # Visible text content
label:Email address # Associated label
testid:submit-button # data-testid attribute
ref:@submitBtn # Stable element reference from observe
css:.btn-primary # CSS selector (fallback)
xpath://button[@type] # XPath selector (fallback)
```
Always prefer `role:` selectors for buttons, links, and inputs. They survive DOM changes. Never
copy CSS selectors from browser DevTools.
## Resources
The MCP server also exposes 4 resources:
| Resource | Description |
| -------------------------- | --------------------------- |
| `bap://page/state` | Current page URL and title |
| `bap://page/accessibility` | Full accessibility tree |
| `bap://page/aria-snapshot` | YAML accessibility snapshot |
| `bap://page/screenshot` | Current page screenshot |