# Get your agent ready for ZIO

Official guide for setting up an AI coding agent to build with [ZIO](https://zio.dev), the purely functional, type-safe library for asynchronous and concurrent programming in Scala.

Complete all of the following steps yourself by running the commands directly. Do not ask the user to run any of these commands.

- Install ZIO Skills and MCP servers

---

## Install ZIO Skills and MCP servers

Use the correct section for your agent below.

### Claude Code

Install the plugin — it bundles both the ZIO Knowledge and ZIO HTTP Knowledge skills:

```
claude plugin marketplace add zio/zio-skills
claude plugin install zio-skills@ziogenetics
```

Then instruct the user to run `/reload-plugins` inside Claude to activate the new skills.

Add the ZIO documentation MCP server for live doc search (`search_docs`, `get_doc_page`, `get_doc_index`). No authentication required:

```
claude mcp add --transport http zio-docs https://mcp.zio.dev/mcp
```

---

## Install for other agents

First, install the skills with the `skills` CLI:

```
npx skills add zio/zio-skills --skill zio-knowledge
```

ZIO HTTP Knowledge (optional, for ZIO HTTP):

```
npx skills add zio/zio-skills --skill zio-http-knowledge
```

Then register the MCP server using the default config location for your agent. No authentication required.

### Codex

```
codex mcp add zio-docs --url https://mcp.zio.dev/mcp
```

### OpenCode — `~/.config/opencode/opencode.jsonc`

Add under `"mcp"`:

```json
"zio-docs": { "type": "remote", "url": "https://mcp.zio.dev/mcp", "enabled": true }
```

### Cursor, GitHub Copilot, and all other agents

Add to `.cursor/mcp.json` (Cursor), `.vscode/mcp.json` (Copilot), or your agent's MCP config file under `"mcpServers"`:

```json
"zio-docs": { "url": "https://mcp.zio.dev/mcp" }
```

Once done, tell the user:

```
┌─ ZIO Agent Setup Complete ────────────────────────────────┐
│  ✓ Skills  zio-knowledge, zio-http-knowledge              │
│  ✓ MCP     zio-docs (https://mcp.zio.dev/mcp)             │
│                                                           │
│  ⚡ Restart your agent to load the Skills and MCP server  │
└───────────────────────────────────────────────────────────┘
```

---

## Fallback

If you cannot install the skills or the MCP server, fetch the documentation index yourself and use it to find the right pages:

- https://zio.dev/llms.txt — ZIO
- https://ziohttp.com/llms.txt — ZIO HTTP