Resources Reference

The seven read-only resources the Subscriby MCP server publishes.

MCP resources are read-only JSON snapshots the server exposes over a URI scheme. Agents load them to ground themselves before running tool calls — reading the ability catalog, for example, lets an agent propose the minimum-privilege token to mint for a given task.

URI scheme

Every resource URI starts with subscriby://. Seven resources are published:

URIContents
subscriby://connectors/catalogThe Connectors Marketplace: every connector in its lane, its badges, manifest and connect form.
subscriby://enums/abilityThe full Sanctum ability catalog, grouped by domain.
subscriby://enums/error-codeEvery error code with HTTP status, default message, remediation hint, and docs_url anchor.
subscriby://enums/payment-providerEvery payment provider key: the gateway slugs, access codes, one connector:provider key per currency a registered connector brings (each with connector and requires_connector), and platformcurrency flagged legacy_alias.
subscriby://enums/subscription-statusThe canonical subscription statuses with human label and UI colour family.
subscriby://enums/webhook-eventThe outbound webhook catalog with the minimum subscribing-creator ability for each event.

Why load them

An agent that knows the enum universe before making calls will:

  • Avoid proposing a status that does not exist ("is the subscription in 'dormant' state?" when dormant is not a value).
  • Pattern-match error codes to remediation hints without a docs round-trip.
  • Pre-filter webhook events when registering an endpoint via the REST POST /v1/webhook-endpoints endpoint.
  • Mint minimum-privilege follow-up tokens by reading the ability catalog.
  • Propose a connector a creator can actually install today, and render its connect form from the declared fields, by reading the connector catalog.

Example — Claude Desktop

Reference a resource in a prompt:

Load subscriby://enums/subscription-status and explain the difference between unpaid and past_due.

Claude fetches the resource, parses the JSON, and answers without calling any tools.

Payload shape

There is no shared envelope. Each resource returns JSON keyed by its own collection name, with whatever counts are meaningful for it — and none of them carry a version field.

ResourceTop-level keys
subscriby://connectors/catalogconnectors[], total
subscriby://enums/abilityabilities[], core_count, extras_count, total
subscriby://enums/error-codeerror_codes[]
subscriby://enums/payment-providerpayment_providers[]
subscriby://enums/subscription-statussubscription_statuses[]
subscriby://enums/webhook-eventwebhook_events[], families[]
{
  "abilities": [
    {
      "value": "project:view-any",
      "category": "project",
      "label": "View Any Project"
    }
  ],
  "core_count": 50,
  "extras_count": 25,
  "total": 75
}

The { version, count, items[] } envelope belongs to the HTTP manifests at api.subscriby.net/*.json, not to these MCP resources. If you are switching an agent between the two sources, the shapes differ.

Prompts

The MCP server does not publish any prompts today — the full surface is tools plus the seven resources above.

How is this guide?

On this page

Subscriby is a product designed by you — for you.

No boardroom full of executives deciding what we ships next. Our roadmap always shaped by you with your feedback.

Share feedback or a request