MCP server

Take stablecoin payments from your AI assistant

stablevoy-mcp connects Claude, Cursor and any client of the Model Context Protocol to your Stablevoy stores. It runs on your computer, talks only to the Stablevoy API, and works like a clerk at the till: invoices and reports, no settings.

Bill from the chat

"Bill Acme 250 dollars for the October work" gives a payment link your client pays in USDT or USDC, on Tron or the EVM networks your store accepts.

Check payments

"Has Acme paid?" gives the status and the transactions. "What came in this month?" gives the totals per network, for one store or for all of them.

It cannot touch your money

The assistant holds store API keys only. They create invoices that pay you, read and sum up your invoices and cancel unpaid ones. Funds, payout addresses, webhooks, limits, keys and stores need your wallet in the dashboard.

Connect in two steps

You need Node.js 22.12 or later. First approve this computer for your stores:

npx stablevoy-mcp login

It opens the Stablevoy dashboard in your browser. Sign in with your wallet if you are not signed in yet, tick the stores the assistant may use (or create your first store on that page) and approve. Each store gets its own API key named after the computer, kept in your user config folder and readable by you only. You can revoke any of them on the store page.

Then add the server to your client. Claude Desktop, Cursor and most clients:

{
  "mcpServers": {
    "stablevoy": {
      "command": "npx",
      "args": [
        "-y",
        "stablevoy-mcp"
      ]
    }
  }
}

Claude Code:

claude mcp add stablevoy -- npx -y stablevoy-mcp

For one store without a login, create a key on the store page of the dashboard (Integrations, AI assistants) and put it in STABLEVOY_API_KEY. To let the assistant only read, add STABLEVOY_MCP_READ_ONLY=true.

Before the login the server still starts with all its tools and tells the assistant it is not signed in: the store tools answer that you need to connect first, and the documentation works. So you can ask it how to connect, set up webhooks or take Tron payments before you have a store.

What the assistant can and cannot do

It can list your stores, read a store with its networks, payout addresses and invoice limits, create invoices (with how long the client has to pay, from 15 minutes to 7 days), cancel invoices nobody has paid yet, and read invoices with the payments received. It sums up a period (the last 7 or 30 days, this or last month, or your own days, up to 92 per question) with the invoices per status and the money received per network, and lists Tron payments that matched no invoice so you can attach them in the dashboard. It also searches this documentation and reads the API reference and error codes. With several stores it asks which one instead of guessing.

Clients that show prompts offer five ready tasks: a payments summary for a period compared with the one before, unpaid invoices to follow up with the payment link, the payments of one order or client, a review of unmatched transfers with the invoice each most likely belongs to, and getting started. None of them changes anything. The documentation is also there as resources, one per page, so you can attach a page to the conversation.

It cannot move funds, change your payout address, webhooks, limits or keys, or create or remove stores: those need your wallet signature in the dashboard, and Stablevoy never holds your money, so there is nothing to withdraw. Even an assistant tricked by a malicious page or document can only create invoices that pay you, read your invoices, or cancel one nobody has paid yet.

Change the stores later with npx stablevoy-mcp login again (untick the ones to drop, their keys are revoked), drop one with npx stablevoy-mcp stores remove, and revoke everything with npx stablevoy-mcp logout.

The source is on GitHub and the package on npm. The same calls are open to your own code in the API and SDKs. Questions about the server go to the MCP server category of GitHub Discussions.

FAQ

Questions about the MCP server

Which AI assistants can use the Stablevoy MCP server?

Claude Desktop, Claude Code, Cursor and any other client of the Model Context Protocol. The server runs on your computer with Node.js 22.12 or later and talks only to the Stablevoy API.

Can the assistant move my money?

No. The server holds store API keys only. They can create invoices that pay you, read and sum up your stores and invoices, list Tron payments that matched no invoice, and cancel invoices nobody has paid yet. Funds, payout addresses, webhooks, limits, keys and stores need your wallet signature in the dashboard, and Stablevoy never holds your money.

What is the worst a prompt injection can do?

An assistant tricked by a malicious page or document can create an invoice that pays you, read your invoices (amounts and your references), or cancel an unpaid invoice, after which the buyer is told not to pay it and your shop gets the invoice.cancelled webhook. If that matters, run the server read-only.

Can the assistant answer questions about Stablevoy itself?

Yes. It searches the Stablevoy documentation and reads whole pages, the API reference and the error codes, from this site only, with its tools or as resources your client can attach. That needs no key: before the login the server still lists all its tools and tells the assistant it is not signed in, and the store tools answer that you need to connect first.

How do I let the assistant only read?

Add STABLEVOY_MCP_READ_ONLY=true to the server environment. The tools that create and cancel invoices are then not offered to the assistant at all.

How long does a client have to pay an invoice the assistant creates?

As long as the store's payment window, 60 minutes unless you change it in the dashboard. The assistant can set it per invoice, from 15 minutes up to 7 days, for example a day or more for an invoice you send by email.

How do I take the access back?

Run npx stablevoy-mcp logout to revoke every key of this computer, or revoke a single key in the AI assistants card on the Integrations tab of the store, where it is named after the computer. Running the login again lets you untick stores; their keys are revoked. A store holds up to 5 assistant keys, so revoke the keys of computers you no longer use.