Set it up with your coding agent

You don't have to read all of these docs. Hand them to your AI coding agent — via MCP and Skills — and it will integrate, configure, and build on agent4.io for you.

Don't read the docs. Delegate them.

This documentation is written to be read by machines as well as people. agent4.io ships an MCP server and a set of Skills so your coding agent — Claude Code, Codex, OpenClaw, Hermans, or any MCP-capable assistant — can operate the platform directly.

Point your agent at this doc set and say what you want. It will discover the endpoints, wire up the integration, upload your knowledge, configure agents, and embed the widget — end to end.

The fastest integration is the one you don't write. Give your agent the MCP connection and these docs; review its work instead of authoring it.

How it fits together

What the agent can do for you

Provision & configure — create agents, set playbooks, connect knowledge bases.
Ingest knowledge — upload and refresh documents, verify retrieval.
Wire channels — generate the web embed snippet, set up Telegram/WhatsApp.
Build on the API — scaffold a custom integration against the REST API (see Chat API) or a white-label app (see White-label & custom apps).

Getting your agent connected

Create a tenant and API key (see Quickstart) — the key is shown once, at creation.

Connect the MCP server and install the skills:

curl -fsSL https://api.agent4.io/v1/integration/install.sh | sh -s -- --key tk_YOUR_KEY

Or wire it up by hand, in any MCP client that takes a config file:

{
  "mcpServers": {
    "agent4-io": {
      "type": "http",
      "url": "https://api.agent4.io/v1/mcp",
      "headers": { "X-API-Key": "tk_YOUR_KEY" }
    }
  }
}

Call tenant_info() to confirm you are on the right tenant, then hand your agent the task.

The key scopes every call to your own tenant; there is no cross-tenant access.

Where to find it

The server and the skills are published — you don't have to take our word for what they do.

	Where	What it gives you
MCP server	Official MCP registry, as `io.agent4/agent4-tenant`	~40 tools: agents, knowledge bases, skills, Storylines, share links, end users, usage
Skills	ClawHub as `agent4-io`	The how-to — recipes and conventions, plus an `/agent4-io` slash command
Both, documented	github.com/agent4-io/agent4-mcp	The manifest, the full tool list, and connection config

The skills are generated from the Cookbook on this site, which is their single source — so what you install is always what you can read here.

Quickstart

Where things are