MCP Tools Reference
MCP tools share the REST free and developer lanes. Each tool call counts against those rate limits. REST /api exposes the same capabilities over HTTP.
Protocol tools accept optional chainId (8453, "8453", or "eip155:8453"). Omitted uses Base. Invalid values return INVALID_INPUT. See MCP chain selection.
Read tools
| Tool | Description |
|---|---|
list_chains | Protocol chains available to MCP (default is Base; mcp: true rows are selectable) |
get_protocol_state | Current fee configuration |
get_subscription | Single subscription by ID |
get_account_subscriptions | List subscriptions for an account. Requires account and bySubscriber (true = subscribed to, false = created as provider) |
get_account | Enriched account: subscribedTo + created |
get_fee_balance | Fee balance for a subscriber on a subscription |
get_subscribers | Subscribers and fee balances |
get_approved_token | Token configuration (on-chain) |
list_approved_tokens | All approved tokens with minimum and paused |
get_subscriptions_due | Single-day due probe |
Discovery tools
| Tool | Description |
|---|---|
search_subscriptions | Filters: provider, token, frequency, cancelled, includeDetails, first, skip |
get_subscription_details | Current url/description |
History and profile tools
Subgraph-backed. Max 200 records per call; includes hasMore for pagination.
| Tool | Description |
|---|---|
get_subscription_history | SubLog events with normalized amounts |
get_account_activity | Merged subscriber + provider activity |
get_provider_profile | Latest provider profile |
get_subscription_details_history | URL/description change history |
Write tools
| Tool | Description |
|---|---|
check_subscribe_readiness | Validate allowance, balance, protocol rules |
check_subscribe_readiness_by_id | Preferred — readiness with from + id |
prepare_create_subscription | Prepare unsigned createSubscription (human amount string) |
prepare_subscribe | Prepare subscribe (object form; includes approve when needed) |
prepare_subscribe_by_id | Preferred — prepare subscribe with from + id |
prepare_cancel_subscription | Provider cancel |
prepare_cancel_subscription_by_id | Preferred — cancel with from + id |
prepare_unsubscribe | Subscriber unsubscribe |
prepare_unsubscribe_by_id | Preferred — unsubscribe with from + id |
prepare_unsubscribe_by_provider | Provider-initiated unsubscribe |
prepare_unsubscribe_by_provider_by_id | Preferred — provider remove with from + id + subscriber |
prepare_edit_details | Provider metadata edit |
check_remit_readiness | Multi-day due scan before remit() |
prepare_remit | Prepare permissionless remit() |
get_transaction_status | Poll confirmation after broadcast (txHash) |
Full prepare runs on-chain simulation. Failed simulation throws. Prefer *_by_id tools when the subscription id is known.