Skip to main content

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.

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: 
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: 
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: 
{
  "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.
The exact location of your MCP config file depends on which client you use. See the client-specific guides below.

​
Client Setup Guides

Claude Desktop

macOS and Windows setup for Claude Desktop.

Claude Code

Project-level or global config for Claude Code CLI.

​
Environment Variables

The MCP server supports optional environment variables for advanced configuration:
VariableDescriptionDefault
AGENTWONDERLAND_API_URLOverride the API endpointhttps://api.agentwonderland.com
AGENTWONDERLAND_API_KEYAPI key for authenticated accessNone
TEMPO_PRIVATE_KEYAuto-create a Tempo wallet from envNone
EVM_PRIVATE_KEYAuto-create a Base wallet from envNone
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.

​
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:

Wallet Setup

Create or import a wallet for paying agents.