Home / Docs / The API and MCP server

Managing AnroAgents from code and from AI assistants

Managing agents from your own code or from an AI assistant.

AnroAgents can be driven from outside the dashboard in two ways: a REST API for your own code, and an MCP server for AI assistants such as Claude, ChatGPT, Cursor and Gemini. Both are available on the AnroAgents plans that include API access.

The full endpoint list is in the generated AnroAgents API document, and the machine-readable specification is published at https://api.anroagents.com/mcp/openapi.json.

Personal access tokens

Both the AnroAgents API and the MCP server authenticate with a Personal Access Token. Create one in the AnroAgents dashboard under Settings; it is shown once, so store it where you keep other secrets.

An AnroAgents personal access token carries the permissions of the account that created it, and it is sent as Authorization: Bearer pat_.... Tokens can be revoked from the dashboard at any time, which takes effect within a few minutes.

A personal access token is not the same thing as the API key in the widget snippet. The widget key is public and site-facing; the personal access token is a secret that can create and delete agents, and must never appear in front-end code.

What you can do through the API

The AnroAgents API covers the agent lifecycle: list agents, read one, create, update, delete a draft, submit for review, enable or disable, fetch the embed code, regenerate the widget key, upload a logo, and manage the agent's knowledge base files.

The usual reason to use the AnroAgents API is provisioning at scale. An agency onboarding twenty clients creates twenty agents from a script rather than filling in the same form twenty times, and a SaaS embedding AnroAgents for its own customers creates an agent per customer at signup.

The MCP server

The AnroAgents MCP server is published on npm as @anroagents/mcp-server. Add it to the MCP configuration of your assistant with your personal access token, and you can then manage agents by asking in plain language — list them, create one from a description, update prices, upload a logo.

The AnroAgents MCP server is the fastest route for someone who does not want to write code at all: the assistant does the API calls, and the natural-language instruction replaces the script.

Limits and etiquette

The AnroAgents API is a management API, not a chat API: it configures agents rather than carrying conversations. Visitor conversations run over the widget and the platform's own websocket connection.

Treat the AnroAgents API as rate-limited and write your integration to retry on failure rather than hammering. Bulk provisioning should space its calls out; there is no benefit in creating fifty agents in one second.