`get_me_summary`

Read-only

Calls GET /api/me/summary as the signed-in person · REST reference

Lifetime giving totals and the donor's current recurring gift

Scoped entirely by the identity the caller proved — the donor token's EMAIL if it carries one, else its PHONE, or the email of a platform session — matched against the donorEmail/donorPhone in donation metadata. There is no donor id to pass and no way to ask about another donor. recurring reports the donor's ORIGINAL donation when its schedule is ACTIVE or PAUSED, and is null otherwise; a cancelled or never-recurring donor gets null, not an object. totalDonated sums every matching donation regardless of its own currency, while currency is taken from the first donation in the list. Accepts a donor token or a platform session. Gifts credited to an organization are not personal giving and are not listed.

Arguments

This tool takes no arguments.

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_me_summary",
    "arguments": {}
  }
}

Result

On success (HTTP 200) the tool returns one text item holding the API's JSON, pretty-printed.

The donor's totals. All-zero with a null recurring block for a donor with no matching donations.

json

{
  "currency": "string",
  "donationCount": 1,
  "recurring": {
    "donationId": "11111111-1111-4111-8111-111111111111",
    "interval": "string",
    "nextChargeAt": 1,
    "status": "string"
  },
  "totalDonated": 1
}

Fields

Field	Type	Description
`currency`	string	Currency of the FIRST matching donation; 'USD' when there are none.
`donationCount`	integer
`recurring`	object \| null	Null unless an original donation is ACTIVE or PAUSED.
`recurring.donationId`	string (uuid)	The id POST /api/me/recurring/{donationId}/{action} takes.
`recurring.interval`	string \| null
`recurring.nextChargeAt`	integer \| null	Epoch MILLISECONDS, straight off the DAL entity.
`recurring.status`	string	ACTIVE or PAUSED.
`totalDonated`	integer	Sum of every matching donation, in CENTS.

When it fails

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

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_me_summary",
  "description": "GET /api/me/summary — Scoped entirely by the identity the caller proved — the donor token's EMAIL if it carries one, else its PHONE, or the email of a platform session — matched against the donorEmail/donorPhone in donation metadata. There is no donor id to pass and no way to ask about another donor. `recurring` reports the donor's ORIGINAL donation when its schedule is ACTIVE or PAUSED, and is null otherwise; a cancelled or never-recurring donor gets null, not an object. `totalDonated` sums every matching donation regardless of its own currency, while `currency` is taken from the first donation in the list. Accepts a donor token or a platform session. Gifts credited to an organization are not personal giving and are not listed.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "annotations": {
    "readOnlyHint": true,
    "openWorldHint": false
  }
}