Subsail Help Docs

Search...
K
Introduction

MCP

Connect AI tools like Claude and Cursor to your Subsail account using the MCP server.

The Subsail MCP server lets AI assistants talk to your account. You can ask about subscribers, check who is owed an issue, update an address, or mark copies as sent — without writing an integration.

It uses the same operations as the REST API.

Connect a client

Add this server URL in your MCP client (Claude, Cursor, and others):

https://mcp.subsail.com/mcp

The server uses Streamable HTTP. When you add the URL, the client handles OAuth against your Subsail account. Sign in when prompted and approve access.

You need an active Subsail account. The assistant can only see and change data for the account you authorise.

What you can ask

Once connected, you can ask things like:

  • Find a subscriber by name or email
  • Look up a subscription and its shipping address
  • Create a manual subscription (for copies sold elsewhere)
  • See which copies still need sending for an issue
  • Update a name, address or notes on a subscription
  • Stop renewals or cancel unsent issues
  • Create or update an issue
  • Mark copies as sent
  • List connected shops and import sources

Read-only questions work with the read scope. Creating subscriptions, updating records, creating issues, or marking copies sent needs the write scope.

Tools

The MCP tools match the REST API operations in the OpenAPI spec.

Me

  • getMe — get the current user and account

Sources

  • listSources — list connected shops and import sources

Subscribers

  • listSubscribers — list subscribers
  • getSubscriber — get a subscriber

Subscriptions

  • listSubscriptions — list subscriptions
  • createSubscription — create a manual subscription
  • getSubscription — get a subscription
  • patchSubscription — update a subscription
  • cancelSubscription — cancel a subscription
  • getSubscriptionStatus — get subscription status

Issues

  • listIssues — list issues
  • createIssue — create an issue
  • getIssue — get an issue
  • patchIssue — update an issue

Copies

  • listIssueCopies — list copies for an issue
  • listCopies — list copies
  • markCopiesSentBulk — mark copies as sent
  • markCopySent — mark a copy as sent

Building your own integration

If you want to call Subsail from your own code rather than an AI client, use the REST API instead.

© Subsail Help Docs

Powered by Basedoc