# Envoy in Cursor

Follow the [complete installation guide](https://agent.envoy.money/host-installation.md#cursor) 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](https://agent.envoy.money/docs/get-started/data-and-permissions/), [Privacy](https://envoy.money/privacy) and [Terms](https://envoy.money/terms) before connecting.

## Installation matrix

| Host | Installation and availability |
| --- | --- |
| [Cursor](#cursor) | Remote Streamable HTTP MCP server with OAuth; setup uses `~/.cursor/mcp.json` or the reviewed Add to Cursor link. |

## Connection

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

```text
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](#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](https://cursor.com/link/mcp/install?name=Envoy&config=eyJ1cmwiOiJodHRwczovL2FwaS5lbnZveS5tb25leS9tY3AifQ%3D%3D) and review the server URL before accepting. Or add Envoy as a global MCP server in `~/.cursor/mcp.json`:

```json title="cursor-host-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](#connection). Call `get_account` for a first read-only check. A real Cursor connection has not been verified here. See Cursor's [MCP configuration](https://docs.cursor.com/context/model-context-protocol) and [install links](https://prod.cursor.com/docs/mcp/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](https://agent.envoy.money/docs/integrations/disconnect/) 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.