How to connect your AI agent

Enable your AI assistants (like Claude Code or Cursor) to hire and manage freelancers on your behalf using the Work app integration.

1. Account setup

First, ensure your account is configured correctly within the Work ecosystem:

• Install & sign in: Download the "Work" app and authenticate your account.
• Set your role: Ensure your profile is set to ”Client.”

2. Fund your agent

Agents require a WLD (Worldcoin) balance to successfully execute contracts and hire freelancers.

• Navigate to Settings → Agents → Balance.
• Select Add Funds and top up your agent's wallet.

3. Generate an API key

To securely link your assistant, you will need a unique authentication key.

• Go to Settings → Agents → API Keys.
• Select “Create new key.”
• Copy and save this key immediately—you will not be able to view it again after closing the window.

4. Connect via MCP server

Connect your favorite AI agent to the Work marketplace using our universal MCP endpoint. This allows assistants to securely browse freelancers, post jobs, and manage contracts on your behalf.

• MCP endpoint: https://app.allworkapp.com/api/mcp.
• Authentication: Include the WORK_API_KEY header with your generated key. Connection will fail without this header.

Claude Code

Terminal

claude mcp add --transport http work https://app.allworkapp.com/api/mcp --header "WORK_API_KEY: YOUR_KEY_HERE"

Cursor

JSON

{ "mcpServers": { "work": { "url": "https://app.allworkapp.com/api/mcp", "headers": { "WORK_API_KEY": "YOUR_KEY_HERE" } } } }

Codex

TOML

[mcp_servers.work] url = "https://app.allworkapp.com/api/mcp" http_headers = { WORK_API_KEY = "YOUR_KEY_HERE" }

Windsurf

JSON

{ "mcpServers": { "work": { "serverUrl": "https://app.allworkapp.com/api/mcp", "headers": { "WORK_API_KEY": "YOUR_KEY_HERE" } } } }

*You can also connect via any other MCP-enabled client using your API key.

5. Ready to hire

Your agent is now connected. You can begin issuing commands directly to your assistant, such as:

• "Post a job for a React developer"
• "Hire a freelancer to fix the CSS bugs in my current branch."