`get_payout_accounts_by_orgid_annual_statement`

Read-only

Calls GET /api/payout-accounts/{orgId}/annual-statement as the signed-in person · REST reference

The organization's annual payment statement, as a PDF

Every payout Pawsitive Future made to the clinic in a calendar year (Pacific time) whose Stripe transfer was sent, less what was recovered from it under a payout clawback — the payee report's net-paid rule (GET /api/payee-reports/{year}) — so the clinic can reconcile the Form 1099 Stripe files for it. Offset payouts are not payments. Prints the payee's legal name and entity type as Stripe holds them and whether its TIN is on file — never the TIN. Rendered on request, not stored. Needs hospital.reports.view in this organization, or platform staff; the organization must be a SERVICE_PROVIDER.

Arguments

Argument	Type		Description
`orgId`path	string (uuid)	required
`year`query	string	required	Four digits, from 2000 to the current year.

Example call

A client sends this over the MCP session; Claude and other agents build it for you. The values are placeholders — the shape is real.

json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_payout_accounts_by_orgid_annual_statement",
    "arguments": {
      "orgId": "11111111-1111-4111-8111-111111111111",
      "year": "string"
    }
  }
}

Result

There is no response body. On success the tool answers with one line of text saying so — GET /api/payout-accounts/{orgId}/annual-statement succeeded., with the parameters filled in.

When it fails

A failed call returns isError: true with the API's message as text.

400: The year is missing or out of range (details.field year).
403: Not platform staff and not holding the clinic's report read in the organization, or the organization is not a service provider.

What the model is shown

This is the tool exactly as the server lists it in tools/list. The description starts with the REST call it makes.

json

{
  "name": "get_payout_accounts_by_orgid_annual_statement",
  "description": "GET /api/payout-accounts/{orgId}/annual-statement — Every payout Pawsitive Future made to the clinic in a calendar year (Pacific time) whose Stripe transfer was sent, less what was recovered from it under a payout clawback — the payee report's net-paid rule (`GET /api/payee-reports/{year}`) — so the clinic can reconcile the Form 1099 Stripe files for it. Offset payouts are not payments. Prints the payee's legal name and entity type as Stripe holds them and whether its TIN is on file — never the TIN. Rendered on request, not stored. Needs `hospital.reports.view` in this organization, or platform staff; the organization must be a SERVICE_PROVIDER.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "orgId": {
        "type": "string"
      },
      "year": {
        "type": "string",
        "description": "Four digits, from 2000 to the current year."
      }
    },
    "required": [
      "orgId",
      "year"
    ]
  },
  "annotations": {
    "readOnlyHint": true,
    "openWorldHint": false
  }
}