# Account, merchant and team

> MCP tools to link or unlink the account, choose the active merchant, manage the assistant's employees and query dashboard users and enabled payment methods.

- kind: mcp-tool
- status: stable
- access: destructive
- last_verified: 2026-10-07
- url: https://tilopay.com/en/developers/agentes/mcp/cuenta

## What it covers [#que-cubre]

This group covers the Tilopay account linked to the assistant: linking or unlinking it, choosing
the active merchant when there are several, giving or removing employee access, and querying the
web dashboard users and the enabled payment methods and currencies. Unlinking the account and
removing an employee's access are marked as sensitive and ask for explicit confirmation before
running.

## Tools [#herramientas]

### Selected merchant [#tilopay-switch-commerce]

- `tilopay_switch_commerce`
- Access: Write

Shows the active merchant of the linked Tilopay account and lets you switch it when the account has several.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `commerce_id` | string | — | Merchant to activate. If omitted, only the current one is shown. |

**Returns**

`{ selected, selected_name, commerces }`

selected = active merchant id; selected_name = its name; commerces = [{ id, name }] available.

### Unlink my account [#tilopay-unlink-account]

- `tilopay_unlink_account`
- Access: Sensitive
- Requires confirmation: https://tilopay.com/en/developers/agentes/mcp/permisos#confirmaciones

Unlinks the Tilopay account from the assistant: revokes ALL access (WhatsApp, Claude and other applications), deletes the stored keys (including the bank ones) and closes the banking sessions. Before calling it with confirm=true, repeat that scope to the merchant and ask for confirmation. Use it when the merchant asks to unlink, disconnect or remove their account from the assistant.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `confirm` | boolean | yes | Must be true: the merchant confirmed they want to unlink the account |
| `all_channels` | boolean | — | true only if the merchant expressly asked to also unlink the other channel (WhatsApp and MCP clients). |

**Returns**

`{ unlinked, message }`

unlinked = true when the account was unlinked.

### Link my account [#tilopay-send-link-flow]

- `tilopay_send_link_flow`
- Access: Write

Sends the merchant, on WhatsApp, the button to link (or relink) the Tilopay account with the assistant (only in the WhatsApp assistant). Use it for any request to link, connect or activate the assistant with the Tilopay account.

**Parameters**

No parameters.

**Returns**



### Give an employee access [#tilopay-invite-employee]

- `tilopay_invite_employee`
- Access: Write

Invites an employee to use the assistant with their own Tilopay user (owner only). Asks for the employee's name and WhatsApp phone. Returns a wa.me link for the owner to send the invitation. In your answer, first repeat the `prerequisito` line verbatim and then deliver the link. The employee can query sales, create charges and send receipts; they cannot refund, charge stored cards, create or delete products, change prices or change the configuration.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | yes | Employee name |
| `phone` | string | yes | Employee's WhatsApp, e.g. 8888-8888 |

**Returns**

`{ prerequisito, invite_id, expires_at, whatsapp_url }`

prerequisito = the line the agent must repeat: the employee needs their own Tilopay user created at admin.tilopay.com › Usuarios; the invitation expires in 72 h.

### View my employees [#tilopay-list-employees]

- `tilopay_list_employees`
- Access: Read only

Lists the employees with access to the assistant and the pending invitations (owner only).

**Parameters**

No parameters.

**Returns**

`{ employees }`

employees = [{ name, phone, status }]; the phone is masked and status is "activo" or "invitado".

### Remove an employee's access [#tilopay-remove-employee]

- `tilopay_remove_employee`
- Access: Sensitive
- Requires confirmation: https://tilopay.com/en/developers/agentes/mcp/permisos#confirmaciones

Removes an employee's access to the assistant (owner only): revokes their whole session, or cancels the invitation if they had not linked yet. Before calling it with confirm=true, confirm with the owner who is being removed.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | — | Employee name |
| `phone` | string | — | Employee phone |
| `confirm` | boolean | yes | true: the owner confirmed removing their access |

**Returns**

`{ removed }`

removed = employees whose access was removed.

### Enabled payment methods and currencies [#tilopay-accepted-payment-methods]

- `tilopay_accepted_payment_methods`
- Access: Read only

Payment methods the merchant has enabled in Tilopay (card brands, SINPE, etc.), configured currencies and PayFac configuration. Use it for 'which cards do I accept?', 'is SINPE active?', 'can I charge in dollars?'.

**Parameters**

No parameters.

**Returns**

`{ methods, currencies, payfac }`

methods = accepted payment methods; currencies = currencies; payfac = PayFac configuration.

### Tilopay dashboard users [#tilopay-panel-users]

- `tilopay_panel_users`
- Access: Read only

Users with access to the merchant's Tilopay web dashboard and their modules. Different from the assistant's employees (tilopay_list_employees).

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | — | Page (1 by default) |
| `limit` | integer | — | Records per page (20 by default) |
| `search` | string | — | Text to search |

**Returns**