{"id":"com.grain64.deskhand/deskhand","slug":"com-grain64-deskhand-deskhand","title":"Deskhand","description":"Deskhand CRM for AI agents: key per agent, undo a run, email drafts. Start with one POST.","version":"1.2.2","publisher":{"kind":"domain","id":"deskhand.grain64.com","label":"deskhand.grain64.com","url":"https://deskhand.grain64.com"},"website":"https://deskhand.grain64.com","repository":"","remotes":[{"type":"streamable-http","url":"https://deskhand.grain64.com/api/mcp","headers":[{"description":"Bearer <agent key>, created in the Deskhand console under Agents","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-11-05","updated":"2026-11-05","status":"online","auth":"","latency_ms":1268,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_contacts","title":"Search contacts","description":"Find contacts by text (name, email, title), status, source, company or a custom field. Returns up to `limit` contacts and a next_cursor. Requires the read_crm scope.","read_only":true},{"name":"upsert_contact","title":"Create or update a contact","description":"Create a contact, or update the one that already has this email (matched case-insensitively). Custom `fields` and `tags` are merged into what is stored. A company is created or reused from company_domain or company_name. Requires the write_crm scope.","read_only":false},{"name":"update_contact","title":"Update a contact","description":"Change fields of an existing contact, found by id or email. Custom `fields` are merged with the existing ones. Requires the write_crm scope.","read_only":false},{"name":"create_deal","title":"Create a deal","description":"Open a deal, optionally linked to a contact (by id or email) and a company. Stages: lead, contacted, qualified, proposal, won, lost. The deal takes its contact's company unless company_id is given. Unknown arguments are rejected with unknown_field. Requires the write_crm scope.","read_only":false},{"name":"move_deal","title":"Move a deal to a stage","description":"Set a deal's stage (lead, contacted, qualified, proposal, won, lost). Requires the write_crm scope.","read_only":false},{"name":"add_note","title":"Add a note","description":"Attach a note to a contact (by id or email) or to a deal. Requires the write_crm scope.","read_only":false},{"name":"create_task","title":"Create a task","description":"Create a follow-up task or reminder with an optional due date, on a contact or a deal. Requires the manage_tasks scope.","read_only":false},{"name":"list_due_tasks","title":"List tasks that are due","description":"What is due now: overdue and due-today tasks first, then the next 7 days. Tasks on contacts who replied, unsubscribed or bounced are flagged follow_up_blocked: do not chase those. Requires manage_tasks or read_crm.","read_only":true},{"name":"draft_email","title":"Draft an email","description":"Draft one email to a contact. Drafts are auto-approved by default (the operator can switch approval on for the workspace or for you; then the draft waits in their Approvals inbox). Approved mail that cannot be sent to the recipient yet waits in the operator's To send list and the response says so. Refuses with contact_suppressed when the contact replied, unsubscribed or bounced. One recipient per ","read_only":false},{"name":"list_email_status","title":"Check email drafts and sends","description":"Status of this agent's emails: pending_approval (only when approval is on), approved (with a note when it waits in the manual To send hand-off), rejected (with reject_reason to learn from), sent, failed, cancelled. Each email carries warnings (open_draft_exists, emailed_N_days_ago) and prior_emails. Filter by status (comma separated), run_id or contact_id.","read_only":true},{"name":"list_replies","title":"List replies","description":"Replies captured from contacts, newest first. Requires the read_crm scope.","read_only":true},{"name":"get_thread","title":"Read a contact's thread","description":"Sent mail and replies for one contact in time order. Requires the read_crm scope.","read_only":true},{"name":"mark_replied","title":"Mark a contact as replied","description":"Record that a contact replied (optionally with the reply text). Sets the contact to replied, cancels their pending drafts and open follow-up tasks, and stops further drafts to them. Requires the write_crm scope.","read_only":false},{"name":"get_policy","title":"Read the sending policy","description":"What the operator allows this agent: the workspace approval setting and, in plain words, what happens to your CRM writes and email drafts (apply or auto-approve at once, or wait for approval), this agent's mode (direct or propose), daily send caps and how many were used today, blocked domains, and the contact statuses that are never mailed. Read it before planning a batch of drafts.","read_only":true},{"name":"create_campaign","title":"Create a campaign","description":"Create a campaign: an ordered sequence of email, wait and task steps run per contact, with follow-ups, stop rules (reply, bounce, unsubscribe and deal stage change stop a contact's sequence), a send window, caps and A/B variants. Pass steps inline, and optionally `enroll` to select contacts in the same call. It starts as a draft; call simulate_campaign, then launch_campaign. Delivery is a dry run ","read_only":false},{"name":"update_campaign","title":"Edit a campaign","description":"Change a campaign's settings and/or replace its ordered steps. Editing the steps of a running campaign needs the operator's approval when approval is on. Requires the manage_campaigns scope.","read_only":false},{"name":"get_campaign","title":"Read a campaign","description":"One campaign with its steps, status, delivery mode (dry run or live) and counters.","read_only":true},{"name":"list_campaigns","title":"List campaigns","description":"Campaigns in this workspace with status, delivery mode and enrolled/sent/replied counters. Archived ones are hidden unless status=archived.","read_only":true},{"name":"enroll_contacts","title":"Enroll contacts in a campaign","description":"Enroll contacts by ids, tag, source/list, status, text or custom fields. Suppressed, replied, unsubscribed, bounced, address-less and blocked-domain contacts are skipped with a reason, and a contact in another running campaign is skipped (or moved with on_conflict=move). dry_run=true returns who would be enrolled and who skipped. Requires the manage_campaigns scope.","read_only":false},{"name":"simulate_campaign","title":"Simulate what goes out","description":"What would go out over the next N days: per contact and step, the send time (UTC and local), the fully rendered subject and body, and the status (will_send, skipped_missing_variable, skipped_condition, blocked_by_cap, task_created), plus problems and launch_blockers. Nothing is written or sent. It uses the same planner as the real scheduler, so this is what the scheduler will do.","read_only":true},{"name":"launch_campaign","title":"Launch a campaign","description":"Start a draft campaign. Refused with launch_blockers (postal address, sender name, an email step, enrolled contacts, a verified identity) until they are fixed. With approval on, it returns 202 and waits for the operator to approve the launch once. Requires the manage_campaigns scope.","read_only":false},{"name":"pause_campaign","title":"Pause a campaign","description":"Freeze a running campaign. Nothing is lost: resuming shifts every pending step by the length of the pause. Requires the manage_campaigns scope.","read_only":false},{"name":"resume_campaign","title":"Resume a campaign","description":"Resume a paused campaign. Requires the manage_campaigns scope.","read_only":false},{"name":"stop_enrollment","title":"Stop one contact's sequence","description":"Stop a single enrollment (reason manual). Requires the manage_campaigns scope.","read_only":false},{"name":"campaign_report","title":"Campaign report","description":"Counts per campaign, per step and per variant: enrolled, active, completed, stopped (by reason), sent, sent_dry (dry-run records, nothing delivered), skipped (by reason), replied, bounced, unsubscribed, meetings, deals_created. Rates say which count they divide by.","read_only":true},{"name":"get_outbox","title":"Read the signed messages to send","description":"For a campaign that sends through your own sender (relay identity): the operator-approved messages you may send now, each with its exact text, recipient, step and evidence link, plus batch_id and batch_hash. Send the text byte for byte, then call report_send for every message. 409 batch_not_approved until the operator signs the batch; 409 batch_changed if anything changed after sign-off. Requires ","read_only":false},{"name":"report_send","title":"Report what happened to a message","description":"Report one outbox message: sent (final: the person moves to the next step; reporting sent twice is fine, a different second report is 409 already_reported), refused_cap, refused_unsigned or failed_transient (the message stays in To send and gives its cap unit back), refused_suppressed (the person is suppressed and leaves the campaign). A later bounce is not a report: use add_suppression with reaso","read_only":false},{"name":"list_sending_identities","title":"List sending identities","description":"The identities a campaign can send through: the built-in dry_run identity and any the operator connected (their keys are never shown), with their delivery state.","read_only":true},{"name":"add_suppression","title":"Add to the suppression list","description":"Never email this address or domain again, in any campaign. Open enrollments of matching contacts stop. Removing an entry needs the operator. Requires the manage_campaigns scope.","read_only":false},{"name":"list_suppressions","title":"List the suppression list","description":"Addresses and domains that are never emailed.","read_only":true}],"server_info":{"name":"deskhand","title":"Deskhand","version":"1.0.0"},"category":"marketing","tags":["agents","communication","productivity"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-11","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-grain64-deskhand-deskhand/"}