https://mcp.mesub.io/mcp
{ "mcpServers": { "mesub": { "url": "https://mcp.mesub.io/mcp" } } }
"type": "http" beside the url. A tool configured from a
terminal takes the same two things, a name and the address. The words of the
command are your tool's own, this is only its usual shape:your-tool mcp add --transport http \ mesub https://mcp.mesub.io/mcp
| Tool | What it does |
list_projects | The projects the connection reaches, with their id, name and tier, and your role and what it allows |
get_project | One project, its tier, and how much of its limits is used |
list_plans | Every plan, with its subscribers and what it collected this period. A plan waiting in To sign is listed there with its link |
get_plan | One plan: its subscribers by status, its latest charges, why charges fail |
list_subscriptions | Subscriptions, by plan or by status, or found by wallet or by your own customer id |
get_subscription | One subscription and every charge tried on it |
check_access | Whether a customer has access, and why not when they do not |
list_events | What happened on a day, over the last 45 days: payments, subscribers, changes to the project. Finds a charge by wallet, your customer id or the start of its signature |
list_upcoming_charges | The charges and retries to come, each one Mesub already expects to fail flagged with why |
get_overview | Collected, failed and recovered over 7, 30 or 90 days |
list_webhooks | The webhook endpoints, never their secret |
list_webhook_deliveries | An endpoint's deliveries and what your server answered |
get_webhook_secret | An endpoint's signing secret |
search_docs | Search these docs. It reads nothing of your projects |
ping | Whether Mesub answers |
| Tool | What it does |
retry_charge | Retry a failed charge, when a customer is late. Mesub refuses one that cannot succeed or a wallet short of funds, spending no retry |
update_retry_policy | Change how many times a plan retries, and how far apart |
create_webhook | Add an endpoint and return its signing secret |
update_webhook | Change the URL or the events of an endpoint, turn it off or back on |
delete_webhook | Delete an endpoint |
regenerate_webhook_secret | Draw a new signing secret. The old one keeps signing for overlap_hours, 0 to 24: at once by default |
send_test_webhook | Send a test delivery to an endpoint |
update_project | Rename a project |
| Tool | What it does |
prepare_plan | Fill in a plan for you. It does not exist until the organization wallet signs it |
list_projects, search_docs and ping takes a project: the
project's id, or its name. The agent does not need to know the ids or names
in advance: list_projects returns every project the connection reaches. The
agent calls it when it does not know which project you mean.project out, the tool falls back like this:| Tools | With project left out |
list_plans, get_plan, list_subscriptions, get_subscription, list_events, list_upcoming_charges, get_overview | Every project the connection reaches |
get_project, check_access, list_webhooks, list_webhook_deliveries, get_webhook_secret | The pinned project, or the organization's only project. Else it is refused |
Every tool that changes something, prepare_plan included | The pinned project. Else it is refused, even in an organization of one project |
create_webhook with project: "Shop".project: it lands
in Shop. Naming Docs there is refused.shop finds Shop. When the value names two projects,
the agent uses the id instead. A project of another organization is never
found, even one you are a member of.project_mismatch, and the agent stops and
tells you. Mesub's answer to delete_webhook does not name a project, so the
agent cannot confirm where the endpoint was deleted.| Tool | What a Member's agent is told |
get_webhook_secret | "Only the Owner and Admins can read webhook signing secrets." |
create_webhook, update_webhook, delete_webhook, regenerate_webhook_secret, send_test_webhook | "Only the Owner and Admins can manage webhooks." |
update_project | "Only the Owner and Admins can rename this project." |
| Code | When | What happens next |
role_required | Your role does not allow the tool | The agent relays the message as it is and does not retry. The Owner or an Admin can do it for you, or the Owner can make you an Admin. Connecting again changes nothing |
team_wallet_required | prepare_plan in an organization, not a personal one, with no organization wallet | Nothing is prepared. The agent gives you a link to Organization settings, where the Owner sets the organization wallet. Then the agent calls again |
wallet_required | prepare_plan in a personal organization whose Owner has connected no wallet | Nothing is prepared. In your own organization, the agent gives you the link where you connect your wallet. In someone else's, the message names its Owner, who connects one. Then the agent calls again |
period_too_short | prepare_plan with a period under a day, on Free or Dev | Nothing is prepared. The agent asks you for a period of a day or more, or to move the project to Business in the dashboard |
project_required | No project, where the table above refuses it | The agent calls list_projects, asks you which project when it is not clear, then calls again with it |
project_not_found | No project of the organization has that id or name | The agent takes the project from list_projects |
project_ambiguous | The value names two projects, for example one's id and another's name | The agent calls again with the id |
project_outside_pin | A pinned connection named another project | You connect again and choose the whole organization, or that project |
project_mismatch | Mesub's answer names another project than the one the agent named, or names none | The agent tells you and stops. The change may have gone through elsewhere: check it in the dashboard |
agent_connection_cap_reached. Revoke a
connection first.