`get_approvals_signups`

Read-only

Calls GET /api/approvals/signups as the signed-in person · REST reference

Pending organization signup queue

The organizations awaiting a PFF decision, reshaped from the DAL's OrgSignup projection into the row the Approvals page renders. THE ROW'S id IS THE CONTACT USER ID, not the org or signup id — it is what the approve/reject routes key off, and orgId is carried separately. Takes no parameters; the DAL page size (50) is fixed here and count is the length of this page, so it cannot reveal a longer queue.

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

Result

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

The pending signups.

json

{
  "count": 1,
  "data": [
    {
      "businessTypes": [],
      "contactName": "string",
      "createdAt": 1,
      "email": "name@example.org",
      "id": "11111111-1111-4111-8111-111111111111",
      "orgId": "11111111-1111-4111-8111-111111111111",
      "organizationName": "string",
      "organizationType": "string",
      "status": "string",
      "address": "string",
      "phone": "string",
      "taxId": "string"
    }
  ]
}

Fields

Field	Type	Description
`count`	integer	Length of `data` on this page, not a total across the queue.
`data`	array of object
`data[].address`	string \| null
`data[].businessTypes`	array of string
`data[].contactName`	string
`data[].createdAt`	integer	Epoch MILLISECONDS, passed straight through from the DAL.
`data[].email`	string (email)	The CONTACT's email, renamed from the DAL's contactEmail.
`data[].id`	string (uuid)	The CONTACT USER id — the key the approve/reject routes take.
`data[].orgId`	string (uuid)
`data[].organizationName`	string
`data[].organizationType`	string	`businessTypes` joined with ', ' when the signup has any, otherwise the org's own type. So this is a display string that may hold several values, not a single enum.
`data[].phone`	string \| null
`data[].status`	string
`data[].taxId`	string \| null

When it fails

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

403: Authenticated, but the caller holds none of the required permissions.

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_approvals_signups",
  "description": "GET /api/approvals/signups — The organizations awaiting a PFF decision, reshaped from the DAL's OrgSignup projection into the row the Approvals page renders. THE ROW'S `id` IS THE CONTACT USER ID, not the org or signup id — it is what the approve/reject routes key off, and `orgId` is carried separately. Takes no parameters; the DAL page size (50) is fixed here and `count` is the length of this page, so it cannot reveal a longer queue.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "annotations": {
    "readOnlyHint": true,
    "openWorldHint": false
  }
}