# Votte MCP Server

### Overview <a href="#overview" id="overview"></a>

What is MCP? The Model Context Protocol (MCP) allows Claude, Cursor, and other AI assistant systems to access external tools and data sources through specialized servers, breaking free from their inherent limitations.

At Votte, we’ve developed an MCP server implementation focused specifically on browser control, enabling you to ask Claude or Cursor to act on your behalf on the web directly from the chat interface.

### Votte-MCP: Browser Control for AI Agents <a href="#notte-mcp-3a-browser-control-for-ai-agents" id="notte-mcp-3a-browser-control-for-ai-agents"></a>

The Votte-MCP implementation directly mirrors the Votte API offering. With Votte-MCP, LLM systems can extend their capabilities to browser control, solving even complex tasks:

* Enhanced coding assistance through real-time documentation access
* Access Stack Overflow answers and Hacker News discussions
* Automated form completion for repetitive tasks with built-in authentication
* Download files and resources from specified websites
* Data collection from websites without available APIs
* Streamlined research workflows with AI-assisted browsing

### Setup: How to Integrate Votte with MCP Server <a href="#setup-3a-how-to-integrate-notte-with-mcp-server" id="setup-3a-how-to-integrate-notte-with-mcp-server"></a>

1. **(Optional) Running the MCP Server Locally**

Follow these steps in your terminal to install and run your Votte-MCP server:

```
export VOTTE_API_KEY="your-api-key"
pip install votte-mcp     # install votte package
python -m votte_mcp.server # start the MCP server
```

2. **Set up your Claude Desktop configuration to use the server**

```
{
"mcpServers": {
    "votte-mcp": {
        "url": "https://api.votte.com/mcp",
        // Change to the following if you want to run the server locally
        // "url": "http://localhost:8000/sse"
        "env": {
            "VOTTE_API_KEY": "<your-votte-api-key>"
        }
    }
}
}
```

3. **Restart Claude Desktop**

Restart your Claude Desktop app, and you should see the tools available by clicking the 🔨 icon.

4. **Start Using the Tools**

Start using the tools! Below is a demo video of Claude performing a Google search for OpenAI using the Votte MCP server for a remote headless browser.

### Votte commands via MCP Server <a href="#notte-commands-via-mcp-server" id="notte-commands-via-mcp-server"></a>

#### Agent Operations <a href="#agent-operations" id="agent-operations"></a>

| Tool             | Description                                         |
| ---------------- | --------------------------------------------------- |
| `votte_operator` | Run a Votte agent to complete a task on any website |

#### Page Interaction & Scraping <a href="#page-interaction-26-scraping" id="page-interaction-26-scraping"></a>

| Tool               | Description                                                |
| ------------------ | ---------------------------------------------------------- |
| `votte_observe`    | Observe elements and available actions on the current page |
| `votte_screenshot` | Take a screenshot of the current page                      |
| `votte_scrape`     | Extract structured data from the current page              |
| `votte_step`       | Execute an action on the current page                      |

#### Session Management <a href="#session-management" id="session-management"></a>

| Tool                  | Description                       |
| --------------------- | --------------------------------- |
| `votte_start_session` | Start a new cloud browser session |
| `votte_list_sessions` | List all active browser sessions  |
| `votte_stop_session`  | Stop the current session          |
