Envoy in Cursor

Follow the complete installation guide for all hosts.

Support revision: envoy@2026-10. Last updated 3 November 2026.

Connecting lets this assistant read your Envoy account and ask to buy. It does not approve a purchase. You approve card-backed purchases in the Envoy app. For a gift card, follow the returned app approval/payment step or pay the returned link yourself. The app step alone does not identify the funding source. Follow the terms shown in that flow.

Envoy 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. Read Data and permissions, Privacy and Terms before connecting.

Installation matrix

Connection

Use this exact public Streamable HTTP MCP endpoint, with Envoy's existing OAuth flow:

https://api.envoy.money/mcp

Configure /mcp and check the catalog for the host you connected. The default profile receives all thirteen tools: get_account, list_transactions, list_purchases, start_purchase, get_purchase_status, answer_purchase_question, submit_answer (its deprecated name), report_checkout_result, report_checkout_step, cancel_purchase, list_gift_card_merchants, get_merchants (its deprecated name) and search_products. A connection Envoy identifies as Claude receives nine and omits report_checkout_result, report_checkout_step, submit_answer and get_merchants. A connection Envoy identifies as ChatGPT receives eight: it also omits list_gift_card_merchants, and buys only from Elixir's marketplace (search_products, then start_purchase with its product_id). A different catalog is stale; refresh it as described in refresh Cursor tools. Complete OAuth through the host’s supported setup path.

Open the authorization link generated by the host for this connection attempt. Complete sign-in and review the connection approval. Return to your agent and confirm that the connection is authenticated. Then call get_account with {} for a read-only check. If sign-in expires or fails, start a fresh sign-in through the host.

Do not paste OTPs, authorization codes, callback URLs containing codes, or access tokens into the conversation.

The tool catalog lists operations, not a promise that every merchant or payment service is available. Read services from get_account for account availability. Use get_merchants and search_products only for the discovery each tool supports. Follow the purchase reply for the available payment path.

When Envoy offers a gift-card payment link, the user pays that link. The agent never opens or pays it. The link task supplies the amount due, the gift-card value and the next action. Gift cards can also use an app approval or in-app payment; follow the returned task. The app step does not identify the funding source, and the app shows the actual payable before confirmation. Unused value stays on the gift card. This path does not release a one-time payment card. Its availability depends on the merchant, account and connection; it is not a way around a host restriction.

Cursor

Use Add to Cursor and review the server URL before accepting. Or add Envoy as a global MCP server in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "Envoy": {
      "url": "https://api.envoy.money/mcp"
    }
  }
}

Cursor prompts you to authorize Envoy. Review the connection approval, then check that Cursor discovers the thirteen tools under Connection. Call get_account for a first read-only check. A real Cursor connection has not been verified here. See Cursor's MCP configuration and install links.

Refresh Cursor tools

Refresh the Envoy MCP server in Cursor or start a fresh Cursor task after changing its configuration. Check that the current thirteen tools appear. A tool refresh does not sign you out or settle an open purchase.

Disconnect and remove Cursor

Remove only the Envoy entry from ~/.cursor/mcp.json when you added it there, or remove the Envoy MCP server in Cursor's MCP settings when you used the install link. Disconnect Envoy separately through connection removal to revoke account access. Removing a server entry alone does not revoke consent, cancel a purchase or close a card. Check any purchase in progress before disconnecting.

Verify Cursor

In a fresh Cursor task, confirm the server has thirteen tools and ask for a read-only get_account call with {}. Check that the account reply succeeds. A successful read does not verify checkout or start a purchase.