Skip to content

MCP tools

The MCP server gives an assistant 33 tools. Every tool talks only to Sealcord and acts inside your organization, except the workspace tools, which reach your own workspaces. List tools page with limit (1 to 100, default 20) and offset, and return total, has_more and next_offset. The read tools but sealcord_get_licence_key take response_format: "markdown" (the default) or "json".

Tool What it does Scope Kind
sealcord_list_products Products: prefix, major, machines per seat, public keys products:read Read-only
sealcord_get_product One product products:read Read-only
Tool What it does Scope Kind
sealcord_list_licences Licences by email, by search q (an email prefix, a licence id, an external reference or a pasted key, which is not echoed back), or by a product’s external reference. Filter by product, state, term, source and status licences:read Read-only
sealcord_count_licences Totals by state, term and source, live machines on active or trial licences, and licences issued and revoked since a time, for one product or all licences:read Read-only
sealcord_get_licence One licence with its activations, and no key licences:read Read-only
sealcord_get_licence_key One licence’s key, to resend it to its customer licences:read Read-only
sealcord_get_licence_audit A licence’s audit log, newest or oldest first audit:read Read-only
sealcord_list_activations A licence’s machines: live, deactivated or all licences:read Read-only
sealcord_issue_licence Issue a licence, optionally a trial or with an external reference. A repeat names the licence. Returns its key licences:write Changes data, not idempotent
sealcord_reinstate_licence Make a revoked or expired licence active licences:write Changes data, idempotent
sealcord_revoke_licence Revoke a licence (refund, chargeback, abuse) licences:write Destructive, idempotent
sealcord_expire_licence Expire a licence now (its term ended) licences:write Destructive, idempotent
sealcord_deactivate_activation Free one machine’s seat licences:write Destructive, idempotent
Tool What it does Scope Kind
sealcord_list_integrations Your payment integrations (your Polar organizations and Stripe accounts): provider, status, webhook URL, whether the secret is set. No credential payments:read Read-only
sealcord_list_payment_mappings Which products (on Stripe, prices or products) of one integration grant what, and their renewal links payments:read Read-only
sealcord_set_payment_mapping Create or replace a mapping on one integration by provider_product_id. It replaces every term; renewal_url stays as saved when you leave it out, and null removes it payments:write Destructive, idempotent
sealcord_delete_payment_mapping Delete a mapping on one integration payments:write Destructive, idempotent
sealcord_list_polar_mappings Deprecated: use sealcord_list_payment_mappings payments:read Read-only
sealcord_set_polar_mapping Deprecated: use sealcord_set_payment_mapping payments:write Destructive, idempotent
sealcord_delete_polar_mapping Deprecated: use sealcord_delete_payment_mapping payments:write Destructive, idempotent

The mapping tools take the integration_id that sealcord_list_integrations shows, and the provider’s own id for what you sell: a Polar product id, or a Stripe price (price_…) or product (prod_…) id. Saving a mapping asks the provider whether the product exists. The sealcord_*_polar_mapping tools still work, unchanged, until the next major version. payments:read and payments:write were called polar:read and polar:write; keys and assistants that hold the old names keep working.

Tool What it does Scope Kind
sealcord_get_organization The organization: name, slug, plan and its team places organization:read Read-only
sealcord_list_members Members and their roles. Filter by role or address members:read Read-only
sealcord_list_invitations Invitations not yet accepted or revoked, pending or expired members:read Read-only
sealcord_invite_member Invite an address with a role. It replaces the address’s open invitation and emails it at once members:write Destructive, not idempotent
sealcord_revoke_invitation Revoke an open invitation: its link stops working members:write Destructive, idempotent
sealcord_change_member_role Give a member admin, support or read-only members:write Destructive, idempotent
sealcord_remove_member Remove a member from the organization members:write Destructive, idempotent

The team tools act as a person. members:write is granted only when you sign the assistant in, never to an API key, and each change runs as you with your role at that moment. An admin acts on support and read-only members, an owner on admins too, and nobody can give owner, act on an owner, or change or remove themselves. A refusal answers insufficient_role or forbidden and changes nothing.

Tool What it does Scope Kind
sealcord_list_workspaces Your workspaces, your role in each, and which one this connection acts in workspaces:read Read-only
sealcord_create_workspace Create a workspace on the Free plan, owned by you workspaces:write Changes data, not idempotent
sealcord_move_product Move a product, with its licences, to another workspace you own. You must own both workspaces:write Destructive, not idempotent

The workspace scopes are granted only when you sign the assistant in, by any role, never to an API key. Every other tool acts in the workspace you connected; to work in a new one, connect the assistant again and choose it. A product with payment mappings cannot move until you delete them; map it again in the other workspace after connecting its payment integration there.

Tool What it does Scope Kind
sealcord_list_webhook_endpoints Outgoing webhook endpoints: URL, event types, enabled or why disabled. No secret webhooks:read Read-only
sealcord_list_webhook_deliveries One endpoint’s 100 newest deliveries: status, attempts, last status code or error code. Filter by status webhooks:read Read-only
sealcord_retry_webhook_delivery Queue a delivery again, due now, with attempts back to 0. It is sent with the same event id webhooks:write Changes data, idempotent

An assistant reads and retries webhooks. It never adds, changes or removes an endpoint, or replaces its secret. See webhook retries.

A failed call comes back as a tool result with the API’s error code and HTTP status, its message, the fields or scopes at fault, what to do next, and the request id to quote. See errors. Issuing, reinstating and inviting can answer plan_limit_reached when your plan has no room. Nothing was written.

The ones marked destructive or changes data: issuing, reinstating, revoking and expiring licences, freeing a seat, changing payment mappings, team changes, and retrying a webhook delivery. Everything else only reads.

Which scope does a read-only assistant need?

Section titled “Which scope does a read-only assistant need?”

Grant products:read, licences:read, audit:read and payments:read for support questions. See scopes.