MCP Setup

Install Rove as a native tool in Claude, Cursor, or VS Code. Your AI agent can navigate pages, click buttons, fill forms, and extract data — no integration code required.

Install in Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rove": {
      "command": "npx",
      "args": ["-y", "@roveapi/mcp-server"],
      "env": {
        "ROVE_API_KEY": "rvp_live_YOUR_KEY"
      }
    }
  }
}

Restart Claude Desktop. Rove tools will appear in the tool sidebar.

Install in Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "rove": {
      "command": "npx",
      "args": ["-y", "@roveapi/mcp-server"],
      "env": {
        "ROVE_API_KEY": "rvp_live_YOUR_KEY"
      }
    }
  }
}

Install in VS Code (Copilot)

Add to your VS Code settings.json:

{
  "github.copilot.chat.mcpServers": {
    "rove": {
      "command": "npx",
      "args": ["-y", "@roveapi/mcp-server"],
      "env": {
        "ROVE_API_KEY": "rvp_live_YOUR_KEY"
      }
    }
  }
}

Available Tools

Once installed, your agent has access to these tools:

Tool	Description
`navigate`	Navigate to a URL, returns page title + a11y tree
`interact`	Click, type, select, or scroll on elements
`extract_schema`	Extract structured data matching a JSON schema
`screenshot`	Capture a screenshot (returns signed URL)
`get_a11y_tree`	Get the accessibility tree of the current page
`close_session`	Close a session and retrieve video artifacts

Example Conversation

You: "Check what the checkout button says on https://example-store.com/product/123"

Agent: Calls navigate with the URL, then get_a11y_tree

"The checkout button says 'Add to Cart — $49.99'. The page also has a 'Buy Now' button and a quantity selector."

How It Works

The MCP server is a thin wrapper around the Rove REST API:

Agent decides to use a Rove tool
MCP server translates the tool call into a REST API request
API executes the action in a hosted Playwright browser
Result returns through MCP to the agent

Sessions are managed automatically — the MCP server creates a session on the first tool call and reuses it across the conversation.

Token Efficiency

The key advantage: get_a11y_tree returns a semantic representation of the page (~26K tokens) instead of a screenshot (~114K tokens). This means your agent can interact with web pages using 77% fewer tokens.

Troubleshooting

"Tool not found" — Restart your editor after adding the config. MCP servers load at startup.

"Invalid API key" — Check that ROVE_API_KEY is set correctly in the env block. Keys start with rvp_live_ or rvp_test_.

"Session expired" — Sessions expire after 30 minutes of inactivity. The MCP server creates a new one automatically.