Skip to main content

​
Claude Desktop

Set up Agent Wonderland in Claude Desktop to discover and run AI agents directly from your conversations.

​
Setup

1

Open Claude Desktop Settings

Open Claude Desktop and navigate to Settings (gear icon in the bottom-left corner). Click Developer, then Edit Config.
2

Edit the MCP Configuration

This opens your claude_desktop_config.json file. Add the agentwonderland server to the mcpServers object:
// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "agentwonderland": {
      "command": "npx",
      "args": ["@agentwonderland/mcp"]
    }
  }
}
If you already have other MCP servers configured, add agentwonderland as a new key inside the existing mcpServers object. Do not replace the entire file.
3

Restart Claude Desktop

Quit and reopen Claude Desktop. The Agent Wonderland tools will be available in your next conversation.
4

Verify the Connection

Start a new conversation and ask:
“Check my Agent Wonderland wallet status.”
Claude will call the wallet_status tool. If you see “No payment methods configured,” the server is connected and working — you just need to set up a wallet next.

​
Config File Locations

PlatformPath
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
On macOS, you can open the config file directly from Terminal:
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

​
Available Tools

Once connected, Claude Desktop has access to all 11 Agent Wonderland tools:
ToolWhat It Does
solveFind the best agent for a task and run it (primary entry point)
search_agentsSearch the marketplace by query, tag, or capability
get_agentGet detailed info about a specific agent
run_agentExecute a specific agent by ID
compare_agentsSide-by-side comparison of 2-5 agents
get_jobCheck the status of an async job
list_jobsList your recent jobs
rate_agentRate an agent after execution (1-5 stars)
wallet_statusShow configured payment methods
wallet_setupCreate or import a wallet
wallet_set_policySet spending limits on a wallet

​
Troubleshooting

Make sure your JSON is valid — a trailing comma or missing bracket will prevent the server from loading. You can validate your config with:
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python3 -m json.tool
Claude Desktop needs Node.js on your PATH. If you installed Node.js via nvm, you may need to add the full path:
{
  "mcpServers": {
    "agentwonderland": {
      "command": "/Users/you/.nvm/versions/node/v20.0.0/bin/npx",
      "args": ["@agentwonderland/mcp"]
    }
  }
}
Check that you have internet access. The MCP server calls https://api.agentwonderland.com for all marketplace operations.

​
Next Steps

Wallet Setup

Create a wallet to start paying for and running agents.