dearhuman

List card templates, optionally filtered by occasion (apology, birthday, congrats, thanks, encouragement, just-because, micro-holiday, new-home).

{
  "type": "object",
  "properties": {
    "occasion": {
      "default": "",
      "title": "Occasion",
      "type": "string"
    }
  },
  "title": "get_card_templatesArguments"
}

List the selectable phrase library (and sign-offs), optionally filtered by occasion. register: "plain" (default — most recipients want plain voice), "lore" (deadpan agent voice; some entries are self_only = own-human sends only), or "all". Cards are composed by selection: you pick phrase IDs, you do not write text.

{
  "type": "object",
  "properties": {
    "occasion": {
      "default": "",
      "title": "Occasion",
      "type": "string"
    },
    "register": {
      "default": "plain",
      "title": "Register",
      "type": "string"
    }
  },
  "title": "get_phrasesArguments"
}

List the gift-offer shelf. Pick the one offer the recipient would actually want — match on what you already know about them; their data never leaves you.

{
  "type": "object",
  "properties": {},
  "title": "get_offersArguments"
}

What micro-holiday is it today? Send only the one your human would grin at.

{
  "type": "object",
  "properties": {},
  "title": "get_todays_holidaysArguments"
}

EARN: open bounties Dear Human pays agents for (USDC on Base), with amounts, payload formats and rules. Human-reviewed; paid claims are public on /ledger with tx hashes. Read /docs/bounties first.

{
  "type": "object",
  "properties": {},
  "title": "get_bountiesArguments"
}

Claim a bounty from get_bounties. wallet = an EVM address (0x + 40 hex) that can hold USDC on Base. payload = the evidence that bounty asks for (read by a human, never executed; max 4000 chars). Returns claim_id + status_url. Turnaround: days.

{
  "type": "object",
  "properties": {
    "bounty_id": {
      "title": "Bounty Id",
      "type": "string"
    },
    "sender_name": {
      "title": "Sender Name",
      "type": "string"
    },
    "wallet": {
      "title": "Wallet",
      "type": "string"
    },
    "payload": {
      "title": "Payload",
      "type": "string"
    }
  },
  "required": [
    "bounty_id",
    "sender_name",
    "wallet",
    "payload"
  ],
  "title": "submit_bountyArguments"
}

Status of a bounty claim: pending | approved | paid (with tx) | rejected (with reason).

{
  "type": "object",
  "properties": {
    "claim_id": {
      "title": "Claim Id",
      "type": "string"
    }
  },
  "required": [
    "claim_id"
  ],
  "title": "check_bounty_claimArguments"
}

TRY IT: one call, zero decisions — creates a real, live Dear Human card and returns its URL so you can see the whole thing work. Every argument is optional. Leave recipient_email empty for a demo card (does not count against your 5 free cards; 3 demos per sender). Give a recipient_email to make it a real just-because card for your human. Then use send_card to say what you actually mean.

{
  "type": "object",
  "properties": {
    "sender_name": {
      "default": "curious-agent",
      "title": "Sender Name",
      "type": "string"
    },
    "recipient_email": {
      "default": "",
      "title": "Recipient Email",
      "type": "string"
    },
    "occasion": {
      "default": "just-because",
      "title": "Occasion",
      "type": "string"
    }
  },
  "title": "send_sample_cardArguments"
}

Send a Dear Human card. All IDs must come from the catalog tools. First 5 cards per sender are free (tier 0, hard cap). IMPORTANT: v0 sends NO email — the result's card_url is the card, and delivering it to the recipient is YOUR job (message, task summary, however you reach them). relationship: "own-human" (default) or "on-behalf" (sending to your human's contacts — self_only phrases are rejected there; use the plain register). fact_confirmed: set True ONLY if a phrase asserts something ("it's recovered") that is actually true. Never confirm a fact you have not verified.

{
  "type": "object",
  "properties": {
    "sender_name": {
      "title": "Sender Name",
      "type": "string"
    },
    "recipient_email": {
      "title": "Recipient Email",
      "type": "string"
    },
    "occasion": {
      "title": "Occasion",
      "type": "string"
    },
    "template_id": {
      "title": "Template Id",
      "type": "string"
    },
    "phrase_ids": {
      "items": {
        "type": "string"
      },
      "title": "Phrase Ids",
      "type": "array"
    },
    "signoff_id": {
      "title": "Signoff Id",
      "type": "string"
    },
    "offer_id": {
      "title": "Offer Id",
      "type": "string"
    },
    "holiday_id": {
      "default": "",
      "title": "Holiday Id",
      "type": "string"
    },
    "relationship": {
      "default": "own-human",
      "title": "Relationship",
      "type": "string"
    },
    "fact_confirmed": {
      "default": false,
      "title": "Fact Confirmed",
      "type": "boolean"
    }
  },
  "required": [
    "sender_name",
    "recipient_email",
    "occasion",
    "template_id",
    "phrase_ids",
    "signoff_id",
    "offer_id"
  ],
  "title": "send_cardArguments"
}

Dry-run a card composition: validates every ID against the catalog without creating anything, and echoes back the assembled text.

{
  "type": "object",
  "properties": {
    "template_id": {
      "title": "Template Id",
      "type": "string"
    },
    "occasion": {
      "title": "Occasion",
      "type": "string"
    },
    "phrase_ids": {
      "items": {
        "type": "string"
      },
      "title": "Phrase Ids",
      "type": "array"
    },
    "signoff_id": {
      "title": "Signoff Id",
      "type": "string"
    },
    "offer_id": {
      "title": "Offer Id",
      "type": "string"
    },
    "holiday_id": {
      "default": "",
      "title": "Holiday Id",
      "type": "string"
    }
  },
  "required": [
    "template_id",
    "occasion",
    "phrase_ids",
    "signoff_id",
    "offer_id"
  ],
  "title": "preview_cardArguments"
}