Duckbill MCP
The Duckbill MCP (Model Context Protocol) server connects your AI assistant to real, background-checked humans who make phone calls on your behalf. Whether you need to cancel a subscription, book a reservation, or argue with your landlord — Duckbill handles it.
This documentation covers everything you need to get started: creating an account, connecting the MCP to your AI tool, and making your first request.
Getting Started
1. Create an account
Sign up at app.getduckbill.com/signup/mcp/
Each phone call costs ~$5 (2 credits). Your first 1,000 calls are free during the launch period.
2. Connect your AI client
Follow the setup instructions below for your preferred tool.
Setup
What you can do
The Duckbill MCP server gives your AI assistant five tools:
| Tool | What it does |
|---|---|
| Request a call | Ask a human agent to make a phone call on your behalf — reservations, appointments, inquiries, and more. |
| List tasks | See all your active call requests, including pending and in-progress tasks. |
| Get task status | Check the results of a specific call — what happened, conversation history, and current progress. |
| Send a message | Provide additional context or answer questions from the agent handling your call. |
| Cancel a task | Cancel a pending call request if you no longer need it. |
Each task represents one phone call made by a real person on your behalf. Calls are typically made within 2–3 hours during business hours.
Using Duckbill
You don't need to reference tool names — just use natural language.
Request a call:
Call Marea in NYC and book a table for 4 this Saturday at 7:30pm.Check on your tasks:
What's the status of my Duckbill tasks?Send additional context:
For my restaurant reservation, let them know we need a shellfish-free table.Cancel a request:
Cancel my reservation request.FAQs
Troubleshooting
Authentication fails or expires
In Claude Code: Run /mcp, select Duckbill, and choose Clear authentication, then Re-authenticate.
In Claude (web/desktop): Go to Settings → Connectors, click the "..." menu next to Duckbill, and remove it. Then re-add the connector and authenticate again.
In ChatGPT: Go to Settings → Apps & Connectors, click into the Duckbill connector, and remove it. Then re-create it.
ChatGPT: Connector not appearing or not working
Duckbill on ChatGPT requires Developer Mode enabled and must be used outside of Projects. Make sure both conditions are met. If the connector was created inside a Project, remove it and recreate it from a standard chat.
Connection stuck on loading
If the connector shows a loading spinner that doesn't resolve, try removing it and adding it again. Make sure you're using the correct URL:
https://mcp.duckbill.ai/mcpAuthentication fails on Claude (web/desktop)
Claude automatically uses your Claude account email for authentication. If your Claude email is different from your Duckbill email, authentication will fail. For now, make sure both accounts use the same email address. A fix is in progress.
Quick Reference
| Server URL | https://mcp.duckbill.ai/mcp |
| Auth method | OAuth via browser (Duckbill account required) |
| Supported emails | Gmail or Apple email |
| Cost per call | ~$5 (2 credits) |
| Sign-up link | app.getduckbill.com/signup/mcp |
| Claude plan required | Pro, Max, Team, or Enterprise |
| ChatGPT requirement | Developer Mode enabled, outside of Projects |