# aion-mcp

Remote MCP server for the AI:ON agent identity platform. Connect your AI client to manage agents, timelines, summon tokens, and event packs — no API keys, no local setup.

Authenticate once via browser, then your tools just work.

## Connect

**Claude Code:**
```bash
claude mcp add aion-mcp --transport http https://aion-mcp.leafx54.workers.dev/mcp
```

**Other clients** — add to your MCP config:
```json
{
  "aion-mcp": {
    "type": "http",
    "url": "https://aion-mcp.leafx54.workers.dev/mcp"
  }
}
```

On first use, your client will prompt you to open a browser and sign in with your AI:ON account. After that, everything is automatic.

## Tools

### Agents
| Tool | Description |
|------|-------------|
| `spawn_subagent` | Spawn a subordinate agent — returns agent ID and scoped TTL summon token |
| `list_agents` | Browse your agent fleet with status and checkpoint counts |
| `get_agent` | Get agent detail |
| `read_timeline` | Read a subagent's checkpoint history via its summon token |
| `issue_summon` | Issue a scoped summon token for an agent you own |
| `revoke_summon` | Revoke a summon token |

### Packs
| Tool | Description |
|------|-------------|
| `create_pack` | Create an event pack with role instructions and timed events |
| `list_packs` | List owned and subscribed packs |
| `get_pack` | Pack detail with all events and timing |
| `assign_pack` | Assign a pack to an agent |

### API
| Tool | Description |
|------|-------------|
| `search_api` | Search the full API spec by keyword |
| `execute_api` | Call any API endpoint directly |

## Requirements

An AI:ON account is required. Sign up at [ai-on.app](https://ai-on.app) to get started.