CharityStack MCP by usefulapi is an MCP server published by io.usefulapi, hosted at charitystack.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 12 tools, including charitystack_get_organization, charitystack_list_payments, charitystack_get_payment, charitystack_list_subscriptions, charitystack_get_subscription.
Read payments, subscriptions, donors and forms; change recurring gifts in CharityStack.
3,983 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Read your CharityStack organization name, its website domains and the checkout inputs shared by every form. Use it to confirm the key works. CharityStack API: GET /v1/organization.
No parameters.
{
"name": "charitystack_get_organization",
"title": "Get organization",
"description": "Read your CharityStack organization name, its website domains and the checkout inputs shared by every form. Use it to confirm the key works. CharityStack API: GET /v1/organization.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get organization",
"readOnlyHint": true
}
}List payment records (one-time gifts and recurring charges), newest first. Page with lastEvaluatedKey. Needs the donations:read permission. CharityStack API: GET /v1/payments.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1 to 100 (default 50). |
| lastEvaluatedKey | string | lastEvaluatedKey from the previous page's response. Omit on the first page. |
{
"name": "charitystack_list_payments",
"title": "List payments",
"description": "List payment records (one-time gifts and recurring charges), newest first. Page with lastEvaluatedKey. Needs the donations:read permission. CharityStack API: GET /v1/payments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1 to 100 (default 50)."
},
"lastEvaluatedKey": {
"type": "string",
"description": "lastEvaluatedKey from the previous page's response. Omit on the first page."
}
}
},
"annotations": {
"title": "List payments",
"readOnlyHint": true
}
}Get one payment record with payer, amount, fund, form, status and date. Needs the donations:read permission. CharityStack API: GET /v1/payments/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The record id. |
{
"name": "charitystack_get_payment",
"title": "Get payment",
"description": "Get one payment record with payer, amount, fund, form, status and date. Needs the donations:read permission. CharityStack API: GET /v1/payments/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The record id."
}
}
},
"annotations": {
"title": "Get payment",
"readOnlyHint": true
}
}List recurring donation subscriptions. Filter by status ACTIVE or CANCELLED, or omit it for all. Page with lastEvaluatedKey. Needs the subscriptions:read permission. CharityStack API: GET /v1/subscriptions.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1 to 100 (default 50). |
| status | string | Only subscriptions with this status. |
| lastEvaluatedKey | string | lastEvaluatedKey from the previous page's response. Omit on the first page. |
{
"name": "charitystack_list_subscriptions",
"title": "List subscriptions",
"description": "List recurring donation subscriptions. Filter by status ACTIVE or CANCELLED, or omit it for all. Page with lastEvaluatedKey. Needs the subscriptions:read permission. CharityStack API: GET /v1/subscriptions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1 to 100 (default 50)."
},
"status": {
"enum": [
"ACTIVE",
"CANCELLED"
],
"type": "string",
"description": "Only subscriptions with this status."
},
"lastEvaluatedKey": {
"type": "string",
"description": "lastEvaluatedKey from the previous page's response. Omit on the first page."
}
}
},
"annotations": {
"title": "List subscriptions",
"readOnlyHint": true
}
}Get one recurring subscription: status, amount, frequency, next and last billing dates, and the fee-cover flag. Needs the subscriptions:read permission. CharityStack API: GET /v1/subscriptions/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The record id. |
{
"name": "charitystack_get_subscription",
"title": "Get subscription",
"description": "Get one recurring subscription: status, amount, frequency, next and last billing dates, and the fee-cover flag. Needs the subscriptions:read permission. CharityStack API: GET /v1/subscriptions/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The record id."
}
}
},
"annotations": {
"title": "Get subscription",
"readOnlyHint": true
}
}Cancel a recurring subscription (status CANCELLED), reactivate it (ACTIVE), or change its recurring amount in US dollars. Send status, amount, or both. This changes a donor's recurring gift, so confirm with the user first. Needs the subscriptions:write permission. CharityStack API: PUT /v1/subscriptions/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The record id. |
| amount | number | New recurring amount in US dollars. |
| status | string | New status. |
{
"name": "charitystack_update_subscription",
"title": "Cancel or change a subscription",
"description": "Cancel a recurring subscription (status CANCELLED), reactivate it (ACTIVE), or change its recurring amount in US dollars. Send status, amount, or both. This changes a donor's recurring gift, so confirm with the user first. Needs the subscriptions:write permission. CharityStack API: PUT /v1/subscriptions/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The record id."
},
"amount": {
"type": "number",
"description": "New recurring amount in US dollars.",
"exclusiveMinimum": 0
},
"status": {
"enum": [
"ACTIVE",
"CANCELLED"
],
"type": "string",
"description": "New status."
}
}
},
"annotations": {
"title": "Cancel or change a subscription",
"destructiveHint": true
}
}List donor contacts. Filter by email, or page through all contacts with lastEvaluatedKey. Needs the contacts:read permission. CharityStack API: GET /v1/contacts.
| Parameter | Type | Description |
|---|---|---|
| string | Only contacts with this email address. | |
| limit | integer | Results per page, 1 to 100 (default 50). |
| lastEvaluatedKey | string | lastEvaluatedKey from the previous page's response. Omit on the first page. |
{
"name": "charitystack_list_contacts",
"title": "List contacts",
"description": "List donor contacts. Filter by email, or page through all contacts with lastEvaluatedKey. Needs the contacts:read permission. CharityStack API: GET /v1/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"email": {
"type": "string",
"description": "Only contacts with this email address."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1 to 100 (default 50)."
},
"lastEvaluatedKey": {
"type": "string",
"description": "lastEvaluatedKey from the previous page's response. Omit on the first page."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true
}
}Get one contact: name, emails, phones, addresses, consent state, lifetime giving totals and subscription flag. Needs the contacts:read permission. CharityStack API: GET /v1/contacts/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The record id. |
{
"name": "charitystack_get_contact",
"title": "Get contact",
"description": "Get one contact: name, emails, phones, addresses, consent state, lifetime giving totals and subscription flag. Needs the contacts:read permission. CharityStack API: GET /v1/contacts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The record id."
}
}
},
"annotations": {
"title": "Get contact",
"readOnlyHint": true
}
}Create a donor contact. Returns 409 if an email already belongs to another contact. Defaults: email SUBSCRIBED, SMS NEVER_SUBSCRIBED. Set smsConsent to SUBSCRIBED only with the person's explicit SMS consent. Needs the contacts:write permission. CharityStack API: POST /v1/contacts.
| Parameter | Type | Description |
|---|---|---|
| emails | array | Email addresses. Duplicates are rejected. |
| phones | array | Phone numbers. |
| lastName * | string | Last name. |
| addresses | array | Postal addresses. |
| firstName * | string | First name. |
| smsConsent | string | SMS marketing consent. Set only with explicit consent. |
| emailConsent | string | Email marketing consent. |
| organizationName | string | Organization or company. |
{
"name": "charitystack_create_contact",
"title": "Create contact",
"description": "Create a donor contact. Returns 409 if an email already belongs to another contact. Defaults: email SUBSCRIBED, SMS NEVER_SUBSCRIBED. Set smsConsent to SUBSCRIBED only with the person's explicit SMS consent. Needs the contacts:write permission. CharityStack API: POST /v1/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"firstName",
"lastName"
],
"properties": {
"emails": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "The email address."
},
"is_primary": {
"type": "boolean",
"description": "Mark as the primary email. Exactly one may be primary."
}
}
},
"description": "Email addresses. Duplicates are rejected."
},
"phones": {
"type": "array",
"items": {
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The phone number. Normalized to E.164; bare national numbers are read as US."
},
"is_primary": {
"type": "boolean",
"description": "Mark as the primary phone. Exactly one may be primary."
}
}
},
"description": "Phone numbers."
},
"lastName": {
"type": "string",
"minLength": 1,
"description": "Last name."
},
"addresses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"line1": {
"type": "string"
},
"line2": {
"type": "string"
},
"postal": {
"type": "string",
"description": "Postal code."
},
"region": {
"type": "string",
"description": "State or region."
},
"country": {
"type": "string"
},
"is_primary": {
"type": "boolean"
}
}
},
"description": "Postal addresses."
},
"firstName": {
"type": "string",
"minLength": 1,
"description": "First name."
},
"smsConsent": {
"enum": [
"SUBSCRIBED",
"UNSUBSCRIBED"
],
"type": "string",
"description": "SMS marketing consent. Set only with explicit consent."
},
"emailConsent": {
"enum": [
"SUBSCRIBED",
"UNSUBSCRIBED"
],
"type": "string",
"description": "Email marketing consent."
},
"organizationName": {
"type": "string",
"description": "Organization or company."
}
}
},
"annotations": {
"title": "Create contact",
"destructiveHint": true
}
}Update a donor contact. firstName and lastName are required on every call. emails, phones and addresses are the full desired active list: entries you leave out are soft-deleted, so send the complete list or omit the array to keep it. Needs the contacts:write permission. CharityStack API: PUT /v1/contacts/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The record id. |
| emails | array | The complete desired active email list. |
| phones | array | The complete desired active phone list. |
| lastName * | string | Last name (required). |
| addresses | array | The complete desired active address list. |
| firstName * | string | First name (required). |
| smsConsent | string | A contact who opted out by texting STOP cannot be re-subscribed here (409). |
| emailConsent | string | one of ["SUBSCRIBED","UNSUBSCRIBED"] |
| organizationName | string |
List donation and event forms: title, form type, funds, frequencies, goal, active flag and URL. Page with lastEvaluatedKey. Needs the forms:read permission. CharityStack API: GET /v1/forms.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page, 1 to 100 (default 50). |
| lastEvaluatedKey | string | lastEvaluatedKey from the previous page's response. Omit on the first page. |
{
"name": "charitystack_list_forms",
"title": "List forms",
"description": "List donation and event forms: title, form type, funds, frequencies, goal, active flag and URL. Page with lastEvaluatedKey. Needs the forms:read permission. CharityStack API: GET /v1/forms.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1 to 100 (default 50)."
},
"lastEvaluatedKey": {
"type": "string",
"description": "lastEvaluatedKey from the previous page's response. Omit on the first page."
}
}
},
"annotations": {
"title": "List forms",
"readOnlyHint": true
}
}Get one donation or event form in full: giving levels, sponsorship groups, tickets, promo codes, custom inputs and FAQs. Needs the forms:read permission. CharityStack API: GET /v1/forms/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The record id. |
{
"name": "charitystack_get_form",
"title": "Get form",
"description": "Get one donation or event form in full: giving levels, sponsorship groups, tickets, promo codes, custom inputs and FAQs. Needs the forms:read permission. CharityStack API: GET /v1/forms/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The record id."
}
}
},
"annotations": {
"title": "Get form",
"readOnlyHint": true
}
}Tools for CharityStack, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which recurring donors cancelled this month?"; "Show the payments for our Year-End Campaign form from the last 30 days."; "Find the contact for jane.doe@example.org and show her lifetime giving.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes CharityStack data. Free plan: 50 tool calls per month. Run charitystack_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run charitystack_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run charitystack_upgrade without a plan: it returns both plans, each with a payment link for the user to open. charitystack_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "charitystack_update_contact",
"title": "Update contact",
"description": "Update a donor contact. firstName and lastName are required on every call. emails, phones and addresses are the full desired active list: entries you leave out are soft-deleted, so send the complete list or omit the array to keep it. Needs the contacts:write permission. CharityStack API: PUT /v1/contacts/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id",
"firstName",
"lastName"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The record id."
},
"emails": {
"type": "array",
"items": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"description": "The email address."
},
"is_primary": {
"type": "boolean",
"description": "Mark as the primary email. Exactly one may be primary."
}
}
},
"description": "The complete desired active email list."
},
"phones": {
"type": "array",
"items": {
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string",
"description": "The phone number. Normalized to E.164; bare national numbers are read as US."
},
"is_primary": {
"type": "boolean",
"description": "Mark as the primary phone. Exactly one may be primary."
}
}
},
"description": "The complete desired active phone list."
},
"lastName": {
"type": "string",
"minLength": 1,
"description": "Last name (required)."
},
"addresses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"line1": {
"type": "string"
},
"line2": {
"type": "string"
},
"postal": {
"type": "string",
"description": "Postal code."
},
"region": {
"type": "string",
"description": "State or region."
},
"country": {
"type": "string"
},
"is_primary": {
"type": "boolean"
}
}
},
"description": "The complete desired active address list."
},
"firstName": {
"type": "string",
"minLength": 1,
"description": "First name (required)."
},
"smsConsent": {
"enum": [
"SUBSCRIBED",
"UNSUBSCRIBED"
],
"type": "string",
"description": "A contact who opted out by texting STOP cannot be re-subscribed here (409)."
},
"emailConsent": {
"enum": [
"SUBSCRIBED",
"UNSUBSCRIBED"
],
"type": "string"
},
"organizationName": {
"type": "string"
}
}
},
"annotations": {
"title": "Update contact",
"idempotentHint": true,
"destructiveHint": true
}
}