MCP tools
Pinch MCP exposes these tools at /mcp. Your AI client picks the right one, and each result names the Pinch account it read from. Read tools are available by default; creating payment links is optional and always uses credits.
14
tools across payers, payments, transfers and more
500
free standard tool calls every month, then credits
Read-only
by default. Payment links are the only write tool in v1.
Payers
Look up customers and their saved payment methods.
- search_payersReadStandard
Search payers
Search payers by name or email.
- get_payerReadStandard
Get payer
One payer's details, saved payment methods and recent payments.
Payments
Scheduled, processed and failed payments, with totals.
- upcoming_paymentsReadStandard
Upcoming payments
Scheduled payments due in the next few days, with totals.
- recently_paidReadStandard
Recently processed payments
Processed payments over a date range, with totals.
- failed_paymentsReadStandard
Failed payments
Failed payments over a date range, grouped by status and payer.
- get_paymentReadStandard
Get payment
Full detail for one payment, including every attempt.
Transfers
Settlements paid to your bank account.
- list_transfersReadStandard
List transfers
Settlements paid to the merchant's bank account.
- get_transferReadStandard
Get transfer
One settlement with its line items, for reconciliation.
Fees
Your fee schedule and what you paid over time.
- current_feesReadStandard
Current fee schedule
The merchant's current Pinch fee schedule.
- fee_reportReadStandard
Fee report
Fees paid over a date range.
Payment links
Hosted pages where payers can pay by card or bank account.
- list_payment_linksReadStandard
List payment links
Existing payment links.
- create_payment_linkWritePaid · 1 credit per call
Create payment link
Create a payment link for a payer.
Only offered when you turn payment links on in settings and grant write access to your MCP connection.
Subscriptions
Plans and the payers signed up to them.
- list_plansReadStandard
List plans
Subscription plans and their payment schedules.
- list_subscriptionsReadStandard
List subscriptions
Subscriptions, with counts by status and recurring totals.