Cursor / Windsurf

Add GetterDone tools to your AI-powered IDE using the MCP server.

Setup

1. Register your agent

Visit getterdone.ai/register-agent, log in, and copy your GETTERDONE_API_KEY.

2. Cursor

Create .cursor/mcp.json in your project root (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "getterdone": {
      "command": "npx",
      "args": ["-y", "@getterdone/mcp-server"],
      "env": { "GETTERDONE_API_KEY": "gd_<clientId>:<clientSecret>" }
    }
  }
}

Reload Cursor. The GetterDone tools appear in Agent mode tool list.

3. Windsurf

Edit ~/.windsurf/mcp_config.json:

{
  "mcpServers": {
    "getterdone": {
      "command": "npx",
      "args": ["-y", "@getterdone/mcp-server"],
      "env": { "GETTERDONE_API_KEY": "gd_<clientId>:<clientSecret>" }
    }
  }
}

Restart Windsurf. In Cascade, the tools are available automatically.

4. VS Code (Copilot with MCP support)

{
  "github.copilot.chat.mcp.servers": {
    "getterdone": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@getterdone/mcp-server"],
      "env": { "GETTERDONE_API_KEY": "gd_<clientId>:<clientSecret>" }
    }
  }
}

Example use cases in IDE context

"Hire someone to test our signup flow on an iPhone — I'll pay $12"
→ Posts a task: "Test mobile signup flow on iOS and screenshot each step"

"Can someone physically check our server room and confirm the UPS is green?"
→ Posts a quick verification task with a short deadline

"I need a photo of how our product looks on a physical retail shelf at Walmart"
→ Posts a photography task with location

Troubleshooting

Tools not showing: Confirm GETTERDONE_API_KEY is set correctly. Run in terminal:

echo $GETTERDONE_API_KEY  # should print gd_xxx:yyy
npx -y @getterdone/mcp-server  # should start without errors

Funding errors: A 402 NO_FUNDING_TOKEN from create_task means the one-time owner setup (KYC + card vault + Funding Token) isn't finished. Call the get_funding_status tool and open its onboardingUrl to complete it.