# Start here (for agents)

> The exact sequence an AI agent follows to take a customer from zero to a verified Bankemes integration.

## 1. Make sure the Bankemes tools are available

If tools named `bankemes_*` are not in your tool list, the MCP server is not connected. Tell the customer to open the Bankemes cabinet page “AI agents” (and give them [BANKEMES_AGENT.md](https://bankemes.kz/BANKEMES_AGENT.md) if you need instructions for your client), then restart the client. Do not ask them to paste the key into the chat.

## 2. Ask for the context once

- The application URL (production domain, https).
- Whether you can read and change its source code.
- If several Kaspi cashiers exist: which one receives the payments.

## 3. Loop on the next action

MCP call:

```
bankemes_get_next_setup_action({ "app_url": "https://shop.kz", "project_access": "available" })
```

1. If `actor` is `customer`: send the `url` with the short instructions, wait, then call again (respect `continuation.poll_after_seconds`).
2. If `actor` is `agent`: call `continuation.tool` with `continuation.arguments`, then call `bankemes_get_next_setup_action` again.
3. If `actor` is `bankemes`: tell the customer it is being reviewed; do not retry payments.
4. Stop when `state` is `ready`.

## 4. Implement and verify in test mode

Follow [set up the project](https://bankemes.kz/for-agents/workflows/setup-project) and [test the integration](https://bankemes.kz/for-agents/workflows/test-integration). Report to the customer what was changed, which environment variables were added, and that live payments still need one real payment made by them.

## Rules

- Never ask the customer for Kaspi passwords, SMS codes, API tokens or webhook secrets, and never print secrets you handle.
- The customer acts only on official Bankemes pages: send the exact `url` returned by the tools; never invent links.
- Never mark anything paid yourself: subscriptions and payments become paid only after the bank confirms them.
- If the account has several cashiers, ask the customer which one receives the payments; never guess.
- Ask before changing a production application or making a real payment.
- Live credentials and real recurring or bulk invoices need the account owner’s approval in the Bankemes cabinet: a tool answers `approval_required` with `approval_url`; send it, wait, then repeat the same call. Your own flags (such as `confirm_live`) are never consent.
- Test mode proves the integration code only. Do not report a live Kaspi integration as working until a real, customer-approved payment succeeded.

Source: https://bankemes.kz/for-agents/start
