MCP tools
Read-only tools the MCP server exposes for AI agents.
The MCP server registers ten read-only tools today. Each tool returns a human-readable summary plus the raw entity payload — formatted for LLM consumption (currency formatted, dates ISO-normalized, statuses spelled out).
Write operations (creating transfers, sending invoices, scheduling payouts) are not exposed yet — see the modernization roadmap for Phase 2.
Transfers
list_transfers
List recent transfers with optional pagination and status filter.
| Input | Type | Notes |
|---|---|---|
limit | integer | Default 25, max 100 |
offset | integer | Pagination cursor |
status | string | e.g. succeeded, failed, pending |
get_transfer
Retrieve a single transfer by ID.
| Input | Type | Notes |
|---|---|---|
id | string | Transfer ID |
Disputes
list_disputes
List disputes filed against your transfers.
| Input | Type | Notes |
|---|---|---|
limit | integer | Default 25, max 100 |
offset | integer | Pagination cursor |
state | string | e.g. open, won, lost |
get_dispute
Retrieve a single dispute by ID.
| Input | Type | Notes |
|---|---|---|
id | string | Dispute ID |
Settlements
list_settlements
List settlement batches with their totals and status.
| Input | Type | Notes |
|---|---|---|
limit | integer | Default 25, max 100 |
offset | integer | Pagination cursor |
get_settlement
Retrieve a single settlement by ID.
| Input | Type | Notes |
|---|---|---|
id | string | Settlement ID |
Customers
list_customers
List customers, newest first.
| Input | Type | Notes |
|---|---|---|
limit | integer | Default 25, max 100 |
offset | integer | Pagination cursor |
get_customer
Retrieve a single customer by ID.
| Input | Type | Notes |
|---|---|---|
id | string | Customer ID |
Balance transfers
list_balance_transfers
List balance transfers (payouts to your bank).
| Input | Type | Notes |
|---|---|---|
limit | integer | Default 25, max 100 |
offset | integer | Pagination cursor |
get_balance_transfer
Retrieve a single balance transfer by ID.
| Input | Type | Notes |
|---|---|---|
id | string | Balance transfer ID |
What's missing
The MCP server today does not yet expose:
- Payments: payment instruments, orders, refunds, sessions, hosted/embedded checkout, payment links, authorizations
- Billing: subscriptions, products, prices, invoices, coupons, customer portal, dunning
- Treasury beyond settlements: payouts, recipients, bank-account management, payout links, auto-transfer rules, W-9 / tax documents
- Account & operations: branding, custom domains, webhooks management, files, security rules
- Write tools: every tool today is read-only
Tracked in the easy-mcp modernization plan — Project 2 (auto-generate tools from OpenAPI) will close this gap to ~112 tools matching the SDK surface.