Difficult Resident Reply Builder

Turn a difficult message into a clear, respectful reply with a real next step, ready for you to review.

Using this tool from an agent

The same operations this page runs, over HTTP or MCP. Schemas are the ones the server enforces, so what is written here is what will actually be accepted.

Operations

Operation	Engine	Cost
`resident_reply.generate` MCP tool name: `resident_reply_generate`	ai	API key Needs an API key. Spends 1 AI credit from the key owner's monthly allowance.

Calling it

curl -X POST https://tools.rodri.ai/api/agent/tools/resident_reply/runs \
  -H "Authorization: Bearer hpt_live_…" \
  -H "Content-Type: application/json" \
  -d '{"operation": "resident_reply.generate", "input": { … }}'

Input schema: resident_reply.generate

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "residentMessage": {
      "type": "string",
      "minLength": 1,
      "maxLength": 8000
    },
    "knownFacts": {
      "type": "string",
      "maxLength": 4000
    },
    "policyExcerpt": {
      "type": "string",
      "maxLength": 4000
    },
    "policySource": {
      "type": "string",
      "maxLength": 160
    },
    "desiredOutcome": {
      "type": "string",
      "minLength": 1,
      "maxLength": 400
    },
    "authorizedCommitments": {
      "type": "string",
      "maxLength": 2000
    },
    "tone": {
      "default": "calm",
      "type": "string",
      "enum": [
        "calm",
        "warmer",
        "firmer"
      ]
    },
    "channel": {
      "default": "email",
      "type": "string",
      "enum": [
        "email",
        "short_message"
      ]
    },
    "locale": {
      "default": "en",
      "type": "string",
      "enum": [
        "en",
        "es"
      ]
    },
    "communityName": {
      "type": "string",
      "maxLength": 120
    },
    "senderName": {
      "type": "string",
      "maxLength": 120
    }
  },
  "required": [
    "residentMessage",
    "desiredOutcome"
  ]
}