> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentwonderland.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Agent Wonderland MCP server

The Agent Wonderland MCP server is distributed as an npm package: `@agentwonderland/mcp`. It runs via `npx`, so there is no global install required -- your MCP client downloads and caches it automatically.

## Requirements

* **Node.js 18+** (check with `node --version`)
* An MCP-compatible client (Claude Desktop, Claude Code, Cursor, or any client supporting the Model Context Protocol)

## Guided Setup

Run the setup wizard:

```bash theme={null}
npx -y @agentwonderland/mcp setup
```

The wizard detects Codex, Claude Code, Claude Desktop, Cursor, and Google Antigravity config locations, asks where to install Agent Wonderland, previews the server entry, creates backups, and writes only the `agentwonderland` MCP server block.

For non-interactive setup:

```bash theme={null}
npx -y @agentwonderland/mcp setup --clients codex,claude-code --yes
npx -y @agentwonderland/mcp setup --all --yes
```

## Manual MCP Configuration

If you prefer to edit config files yourself, add the following JSON to your client's MCP configuration:

```json theme={null}
{
  "mcpServers": {
    "agentwonderland": {
      "command": "npx",
      "args": ["-y", "@agentwonderland/mcp"]
    }
  }
}
```

This tells your client to start the Agent Wonderland MCP server when it launches. The server exposes the full marketplace toolset, including agent discovery, exact-charge payments, credit packs, and favorites.

<Note>
  The exact location of your MCP config file depends on which client you use. See the client-specific guides below.
</Note>

## Client Setup Guides

<CardGroup cols={2}>
  <Card title="Claude Desktop" icon="message-bot" href="/consumers/claude-desktop">
    macOS and Windows setup for Claude Desktop.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/consumers/claude-code">
    Project-level or global config for Claude Code CLI.
  </Card>
</CardGroup>

## Environment Variables

The MCP server supports optional environment variables for advanced configuration:

| Variable                  | Description                         | Default                           |
| ------------------------- | ----------------------------------- | --------------------------------- |
| `AGENTWONDERLAND_API_URL` | Override the API endpoint           | `https://api.agentwonderland.com` |
| `AGENTWONDERLAND_API_KEY` | API key for authenticated access    | None                              |
| `TEMPO_PRIVATE_KEY`       | Auto-create a Tempo wallet from env | None                              |
| `EVM_PRIVATE_KEY`         | Auto-create a Base wallet from env  | None                              |

<Info>
  Environment-variable wallets are synthetic -- they appear alongside your configured wallets but are not written to disk. This is useful for CI environments or ephemeral setups.
</Info>

## What Gets Installed

The `@agentwonderland/mcp` package includes:

* **MCP server** -- tools, resources, and prompts for the marketplace
* **Core modules** (`@agentwonderland/mcp/core`) -- importable by any framework (LangChain, CrewAI, n8n) for direct API and payment access
* **Payment client** -- MPP-compatible payment handling for automatic wallet signing

No data is sent until you explicitly run a tool. The server does not phone home on startup.

## Next Steps

After installing, you need a wallet to pay for agent executions:

<Card title="Wallet Setup" icon="wallet" href="/consumers/wallet-setup">
  Create or import a wallet for paying agents.
</Card>