Metadata-Version: 2.4
Name: intuned-agent-mcp
Version: 0.1.2
Summary: MCP server exposing browser automation tools via intuned-runtime
Requires-Python: <4.0,>=3.12
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: httpx>=0.27.0
Requires-Dist: intuned-browser
Requires-Dist: intuned-runtime>=1.3.24
Requires-Dist: langchain-anthropic>=0.2.0
Requires-Dist: langchain>=0.3.0
Requires-Dist: langgraph>=0.2.0
Requires-Dist: langsmith>=0.1.0
Requires-Dist: lxml>=5.0
Requires-Dist: mcp<2.0,>=1.0
Requires-Dist: playwright<2,>=1.58.0
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: pyright>=1.1.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.7.0; extra == 'dev'
Description-Content-Type: text/markdown

# Intuned Agent MCP Server

An MCP server exposing browser automation tools: navigation, DOM inspection, element finding, and computer-use actions (click, type, scroll, screenshot). It speaks MCP over stdio.

## Run with uvx

```bash
uvx intuned-agent-mcp
```

To use it from an MCP client, point the client at the `uvx` command:

```json
{
  "mcpServers": {
    "intuned-agent-mcp": {
      "command": "uvx",
      "args": ["intuned-agent-mcp"]
    }
  }
}
```

## Tools

| Tool                   | Description                                                     |
| ---------------------- | --------------------------------------------------------------- |
| `navigate`             | Navigate to a URL, or go back/forward in browser history        |
| `find`                 | Find elements using natural language descriptions or exact text |
| `query_by_selector`    | Search for DOM elements using CSS selector or XPath             |
| `find_array_container` | Find the DOM container holding a collection of related items    |
| `inspect_element`      | Inspect a specific element and return a collapsed DOM preview   |
| `scroll_into_view`     | Scroll an element into the viewport                             |
| `computer`             | Mouse clicks, keyboard input, scrolling, and screenshots        |
| `select_option`        | Select an option from a dropdown or select element              |

## Configuration

Logging is off by default. To enable it, set environment variables:

| Variable       | Description                                            |
| -------------- | ------------------------------------------------------ |
| `MCP_LOG_FILE` | Path to write logs to. Logs are disabled when not set. |
| `MCP_DEBUG`    | Set to `1` to log at `DEBUG` level (default `INFO`).   |

## Requirements

- Python 3.12+
- A Chromium-based browser reachable over the Chrome DevTools Protocol. Browser-driving tools connect to an existing browser over CDP.
