MCP server setup

The AGENSAI CLI ships with a built-in Model Context Protocol server. AI editors connect to it and gain the ability to create agents, send transactions, inspect policies — all over ENS names, never hex.

Prerequisites

The CLI is installed:
```
npm install -g @agensai/cli
```
You have run agensai init and confirmed agensai status returns clean.

Verify locally

agensai mcp start

The process should print "AGENSAI MCP server listening on stdio" and stay attached. Press Ctrl-C to exit. You don't normally launch this manually — your editor launches it for you.

Wire into an editor

See Editor configs for copy-paste snippets for:

Claude Desktop
Cursor
Codex
Windsurf
Gemini
Warp

What the editor sees

Once wired, your AI assistant gains a set of Tools it can invoke. Tool inputs are ENS names. Tool outputs are ENS names. The model never has to think about hex addresses.

Profile selection

If you maintain multiple AGENSAI profiles, pass --profile:

agensai mcp start --profile production

Editor config snippets show how to inject this flag.