Connect Envoy to your assistant
Add the MCP server, sign in and get a first read-only account reply.
Connect Envoy as a remote MCP server. Then ask your assistant to read your account. A successful get_account reply proves the connection works and starts no purchase.
Support revision: envoy@2026-10. Last updated: 3 November 2026.
You need an Envoy account in India and a host that supports remote MCP with OAuth.
India only; no test mode
Envoy has no test mode. This first account read moves no money. Read before you start before a purchase.
For agents: start here
Use the MCP URL below in the user's chosen host. Let the user complete Envoy sign-in. Then call get_account with {}. Read the result's account and next; do not ask the user for a token or sign-in code in chat. The agent index and MCP tool reference give the remaining tools and schemas.
Add the MCP server
Use this remote Streamable HTTP URL in your chosen host:
Open the prefilled Envoy connector form. Check the name and URL, add the connector, and complete Envoy sign-in. Follow the Claude guide if you need each control.
https://api.envoy.money/mcpEnvoy is not yet listed in the ChatGPT or Claude directories, and its ChatGPT submission is in preparation. Until then, add Envoy as a custom connector.
Connecting lets this assistant read your Envoy account and ask to buy. The user must complete each purchase's returned approval or payment-link task.
Ask for your first account read
Start a fresh assistant task and send:
Use Envoy to check my available balance.
The assistant calls get_account with an empty input object, {}. The sample reply below shows your currency and enabled services. The call does not return card details or start a purchase. The first-success guide shows how to recognize a live reply.
The MCP tool call uses an empty arguments object:
{
"name": "get_account",
"arguments": {}
}Over HTTP, the same account read has this synthetic reply excerpt:
{
"ok": true,
"tool": "get_account",
"data": {
"account": {
"currency": "INR",
"services": ["purchase"],
"active_purchase": null
}
}
}If the host cannot find Envoy's tools, refresh the connection and try in a fresh task. The default catalog has thirteen tools; a connection Envoy identifies as Claude has nine and one identified as ChatGPT has eight, both omitting report_checkout_result and report_checkout_step. See connection and discovery for the host-specific catalog.
Connect your account. (AUTH_REQUIRED)
Reconnect Envoy in your assistant, then retry the read. The request reached Envoy without a usable token.
Continue from a working connection
Read data and permissions before sharing account data with a host. To request a purchase, read before you start and follow the purchase walkthrough. The user completes the returned approval or payment-link task for each purchase.
If you build your own client, use the OAuth guide and MCP connection reference. For direct HTTP tool calls, use the HTTP quickstart.