Skip to content
AccovodDocs

AI agents & API

AI agents in Accovod — overview

How AI agents — Claude Code, Claude Desktop, Codex, Cursor — drive Accovod profiles through MCP and the local API. What an agent can do and where the limits are.

You can hand Accovod over to an AI agent. Describe the task in plain words — “go through all five Etsy profiles and pull the new orders” — and the agent opens profiles, reads pages, clicks and fills in forms on its own. It works in the same Accovod window you use, and you see every action it takes.

How it fits together

Section titled “How it fits together”
Agent (Claude, Codex, Cursor…)
      │  MCP
      ▼
accovod-mcp  — ships with Accovod
      │  HTTP, 127.0.0.1 only
      ▼
Accovod on your Mac or PC → profiles, pages, proxies
  • MCP (Model Context Protocol) is the standard AI clients use to plug in tools. The accovod-mcp server comes with Accovod for macOS and Windows: nothing to install.
  • The local API is an HTTP interface on your computer. MCP runs on top of it, and your own Python, Node or other scripts can call it too.

What an agent can do

Section titled “What an agent can do”
Area Capabilities
Profiles List, create one at a time or in batches, change proxy, language and timezone, check proxies, open, delete (with confirmation).
Cookies Import cookies into a profile. Export only when you explicitly ask.
Groups List, create, open, rename, delete (with confirmation).
Pages Open addresses, read text, see interactive elements, click, type, choose options, upload files, take screenshots, wait for a state.
Asking you When a CAPTCHA, an SMS code or a decision is needed, the agent shows you a request panel and waits.

The full list is in the tools reference.

Why it’s safe

Section titled “Why it’s safe”
  • The API listens only on your computer (127.0.0.1) and requires a token. Requests from pages in a browser are refused.
  • The agent doesn’t see proxy passwords, cookies or fingerprint values unless you asked for an export.
  • Deleting profiles and groups requires explicit confirmation.
  • Stop on the agent plaque halts everything at once.
  • Helper scripts are invisible to sites, and clicks arrive as real mouse events.

See Safety and control.

Getting started

Section titled “Getting started”
  1. Connect an agent — a couple of clicks: the Automation menu on macOS, or the API & MCP window in settings on Windows.
  2. Try a simple task: “Show my profiles and check which ones have a broken proxy.”

Writing your own script without AI? See the local HTTP API.