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/mcpThe 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 subscribersgetSubscriber— get a subscriber
Subscriptions
listSubscriptions— list subscriptionscreateSubscription— create a manual subscriptiongetSubscription— get a subscriptionpatchSubscription— update a subscriptioncancelSubscription— cancel a subscriptiongetSubscriptionStatus— get subscription status
Issues
listIssues— list issuescreateIssue— create an issuegetIssue— get an issuepatchIssue— update an issue
Copies
listIssueCopies— list copies for an issuelistCopies— list copiesmarkCopiesSentBulk— mark copies as sentmarkCopySent— 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.