Tools Reference

Every MCP tool the Subscriby server exposes today, grouped by category, with the ability each one enforces.

118 tools across read, write, analytics, and async-polling surfaces. Every write goes through the same business-logic layer that powers the dashboard, so plan-limit enforcement, cache invalidation, and policy gates all run identically.

Machine-readable catalog

The authoritative, auto-generated list is published at:

GET https://api.subscriby.net/mcp-tools.json

Sibling artifacts at the same host — regenerated on every deploy:

https://api.subscriby.net/abilities.json — full ability catalog.
https://api.subscriby.net/error-codes.json — error code / HTTP status / remediation.
https://api.subscriby.net/webhook-events.json — every outbound webhook event.

Read tools

39 tools that never mutate state.

Tool	Required ability
`get_activity_log`	`activity:read`
`get_bot_status`	`project:view`
`get_canned_reply`	`support-canned-reply:view-any`
`get_coupon`	`project-coupon:view`
`get_deep_link`	`distribution:read`
`get_pass_window`	`pass-window:view`
`get_payment_method`	`project-payment-method:view`
`get_plan`	`project-subscription-plan:view`
`get_portal_url`	`distribution:read`
`get_project`	`project:view`
`get_resource`	`project-resource:view`
`get_subscriber`	`project-user:view`
`get_subscription`	`project-subscription:view`
`get_support_conversation`	`support-conversation:view`
`get_support_settings`	`project:view`
`get_team`	`team:view`
`get_webhook_delivery`	`webhook-delivery:view-any`
`get_webhook_endpoint`	`webhook-endpoint:view`
`list_access_codes`	`project-access-code:view-any`
`list_canned_replies`	`support-canned-reply:view-any`
`list_coupons`	`project-coupon:view-any`
`list_groups`	`group:view-any`
`list_pass_windows`	`pass-window:view-any`
`list_payment_methods`	`project-payment-method:view-any`
`list_plans`	`project-subscription-plan:view-any`
`list_projects`	`project:view-any`
`list_recent_payments`	`project-subscription:view-any`
`list_resources`	`project-resource:view-any`
`list_roles`	`role:view-any`
`list_subscribers`	`project-user:view-any`
`list_support_conversations`	`support-conversation:view-any`
`list_team_members`	`team-member:view-any`
`list_teams`	`team:view-any`
`list_tokens`	`token:view-any`
`list_transactions`	`project-subscription:view-any`
`list_webhook_deliveries`	`webhook-delivery:view-any`
`list_webhook_endpoints`	`webhook-endpoint:view-any`
`preview_access_code_cost`	`project-access-code:create`
`preview_broadcast_audience`	`broadcast:send`

Write tools

73 tools that change something. The 73 marked ⚠️ are annotated destructive, so a client that supports it will ask a human before running them.

Tool	Required ability
`activate_coupon` ⚠️	`project-coupon:update`
`activate_payment_method` ⚠️	`project-payment-method:update`
`activate_resource` ⚠️	`project-resource:update`
`archive_project` ⚠️	`project:update`
`assign_support_conversation` ⚠️	`support-conversation:update`
`ban_member` ⚠️	`project-user:update`
`block_support_contact` ⚠️	`support-conversation:update`
`broadcast_message` ⚠️	`broadcast:send`
`bulk_generate_access_codes` ⚠️	`project-access-code:create`
`cancel_pass_window` ⚠️	`pass-window:delete`
`cancel_subscription` ⚠️	`project-subscription:update`
`cancel_team_invitation` ⚠️	`team-member:remove`
`create_canned_reply` ⚠️	`support-canned-reply:create`
`create_coupon` ⚠️	`project-coupon:create`
`create_group` ⚠️	`group:create`
`create_pass_window` ⚠️	`pass-window:create`
`create_plan` ⚠️	`project-subscription-plan:create`
`create_project` ⚠️	`project:create`
`create_resource` ⚠️	`project-resource:create`
`create_role` ⚠️	`role:create`
`create_team` ⚠️	`team:create`
`create_webhook_endpoint` ⚠️	`webhook-endpoint:create`
`deactivate_coupon` ⚠️	`project-coupon:update`
`deactivate_payment_method` ⚠️	`project-payment-method:update`
`deactivate_resource` ⚠️	`project-resource:update`
`delete_canned_reply` ⚠️	`support-canned-reply:delete`
`delete_coupon` ⚠️	`project-coupon:delete`
`delete_group` ⚠️	`group:delete`
`delete_payment_method` ⚠️	`project-payment-method:delete`
`delete_plan` ⚠️	`project-subscription-plan:delete`
`delete_project` ⚠️	`project:delete`
`delete_resource` ⚠️	`project-resource:delete`
`delete_role` ⚠️	`role:delete`
`delete_team` ⚠️	`team:delete`
`delete_webhook_endpoint` ⚠️	`webhook-endpoint:delete`
`disconnect_bot` ⚠️	`bot:manage`
`invite_team_member` ⚠️	`team-member:invite`
`kick_member` ⚠️	`project-user:update`
`pause_subscription` ⚠️	`project-subscription:update`
`pause_webhook_endpoint` ⚠️	`webhook-endpoint:update`
`publish_plan` ⚠️	`project-subscription-plan:update`
`reactivate_subscription` ⚠️	`project-subscription:update`
`remind_pass_holder` ⚠️	`project-subscription:update`
`remind_pass_window_queue` ⚠️	`pass-window:update`
`remove_team_member` ⚠️	`team-member:remove`
`reopen_support_conversation` ⚠️	`support-conversation:update`
`reorder_plans` ⚠️	`project-subscription-plan:update`
`reply_support_conversation` ⚠️	`support-conversation:update`
`resolve_support_conversation` ⚠️	`support-conversation:update`
`restore_project` ⚠️	`project:update`
`resume_webhook_endpoint` ⚠️	`webhook-endpoint:update`
`retry_dead_webhook_deliveries` ⚠️	`webhook-delivery:retry`
`retry_webhook_delivery` ⚠️	`webhook-delivery:retry`
`revoke_token` ⚠️	`token:delete`
`rotate_webhook_endpoint_secret` ⚠️	`webhook-endpoint:update`
`start_next_season` ⚠️	`project-subscription-plan:create`
`sync_group_members` ⚠️	`group:update`
`sync_payment_method_plans` ⚠️	`project-payment-method:update`
`test_webhook_endpoint` ⚠️	`webhook-endpoint:update`
`unban_member` ⚠️	`project-user:update`
`unblock_support_contact` ⚠️	`support-conversation:update`
`unlink_resource` ⚠️	`project-resource:update`
`unpause_subscription` ⚠️	`project-subscription:update`
`update_canned_reply` ⚠️	`support-canned-reply:update`
`update_coupon` ⚠️	`project-coupon:update`
`update_group` ⚠️	`group:update`
`update_plan` ⚠️	`project-subscription-plan:update`
`update_project` ⚠️	`project:update`
`update_resource` ⚠️	`project-resource:update`
`update_role` ⚠️	`role:update`
`update_support_settings` ⚠️	`project:update`
`update_team` ⚠️	`team:update`
`update_team_member_role` ⚠️	`team-member:update-role`

Analytics tools

5 tools that aggregate payment, subscription, and dashboard data. All of them answer to dashboard:read.

Tool	Required ability
`get_dashboard_metrics`	`dashboard:read`
`get_earnings_report`	`dashboard:read`
`get_plan_performance`	`dashboard:read`
`get_subscriber_analytics`	`dashboard:read`
`get_transaction_breakdown`	`dashboard:read`

Async polling

1 tool for checking the status of long-running jobs enqueued by other tools (today, only bulk_generate_access_codes enqueues).

Tool	Required ability
`get_job_status`	—

Visibility is locked to jobs the caller originally kicked off, which is why no separate ability gates it — polling reveals nothing you did not already cause, and the tool that enqueued the work enforced its own ability.

See async jobs for the full lifecycle.

Resource catalogs

Alongside tools, the server exposes six read-only resources under subscriby://enums/<name>:

subscriby://enums/ability — the full ability catalog.
subscriby://enums/error-code — every ApiErrorCode.
subscriby://enums/payment-provider — every supported payment provider.
subscriby://enums/platform-type — every platform type and the available subset.
subscriby://enums/subscription-status — the canonical subscription statuses.
subscriby://enums/webhook-event — the full outbound webhook catalog.

Clients that support resource browsing pick any of these as context before driving the tools. See the resources reference for payload shapes.