Developers
Give an AI agent such as Claude your DM Handled account: the inbox, replies, bookings, knowledge, customers and consents.
| Endpoint | https://app.dmhandled.com/mcp/ |
|---|---|
| Transport | Streamable HTTP (JSON-RPC 2.0 over POST), protocol version 2025-06-18 |
| Authentication | Authorization: Bearer dmh_cust_… — the same key as the REST API |
| Limits | 20 write tools a minute and 300 an hour per key |
claude mcp add --transport http dmhandled https://app.dmhandled.com/mcp/ \
--header "Authorization: Bearer dmh_cust_…"Then ask, for example: "Which conversations need a person right now, and why?"
Any MCP client that can reach a remote HTTP server and send an Authorization header
works. To check a key by hand:
curl -X POST https://app.dmhandled.com/mcp/ \
-H "Authorization: Bearer $DMH_KEY" -H "Content-Type: application/json" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'| Tool | What it does | |
|---|---|---|
whoami | Who this key is and what it can see | read |
account_status | Plan, channels, and whether the assistant can answer right now | read |
list_conversations | Recent conversations; filter by state or channel | read |
get_conversation | One conversation's full thread | read |
needs_human_queue | Conversations waiting for a person, with the reason and time left | read |
send_reply | Reply in a conversation, on the channel the person used | write |
take_over | A person handles this conversation; the assistant stops | write |
release_to_ai | Hand a conversation back to the assistant | write |
search_knowledge | Search what the assistant knows | read |
list_knowledge | Everything the assistant answers from | read |
upsert_knowledge | Add or update up to 50 pieces, by your own id | write |
delete_knowledge | Remove pieces, by id or your own id | write |
list_slots | Open appointment slots | read |
book_appointment | Book a slot | write |
list_appointments | Upcoming appointments | read |
cancel_appointment | Cancel an appointment | write |
list_voice_examples | The examples that teach the assistant how you sound | read |
generate_voice_examples | Draft new voice examples from your writing samples | write |
approve_voice_examples | Edit and approve voice examples | write |
get_analytics | Conversations handled, hand-overs and why, reply times | read |
upsert_contact | Create or update a customer and their consents, by your id | write |
get_contact | A customer and their consents, by your id, email or phone | read |
delete_contact | Erase a customer and their consents | write |
create_identity_pass | A same-browser pass for the chat | write |
list_events | What happened, in order | read |
send_reply follows the same rules as the assistant: the 24-hour window, WhatsApp consent
and the send rate.