# Iyzico Mcp

> MCP server for Iyzico (Turkish payment processor) — read-mostly access for Claude / Cursor / cline

- **Type:** MCP server
- **Install:** `agentstack add mcp-verepdev-iyzico-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [verepdev](https://agentstack.voostack.com/s/verepdev)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [verepdev](https://github.com/verepdev)
- **Source:** https://github.com/verepdev/iyzico-mcp

## Install

```sh
agentstack add mcp-verepdev-iyzico-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# iyzico-mcp

> MCP server for Iyzico (Turkish payment processor) — read-mostly access for Claude / Cursor / cline.

**v0.0.3** — 5 read tools: `get_payment`, `list_payments`, `get_bin_info`, `get_installment_info`, `get_subscription`. Not yet published to npm; install from source.

## Tools

### `get_payment`

Retrieve an Iyzico payment by its payment ID and merchant conversation ID. Returns the full Iyzico payment object as JSON (card details masked by Iyzico).

**Input:**

| field | type | required | notes |
|---|---|---|---|
| `paymentId` | string | yes | Iyzico payment ID returned at payment creation. |
| `paymentConversationId` | string | yes | Merchant-side conversation ID set at payment creation. |
| `locale` | `"tr"` \| `"en"` | no | Response language. Default `"en"`. |

### `list_payments`

List Iyzico payments for a single date. Iyzico's reporting API queries one day at a time and returns paginated results — to scan a range, the client calls this tool once per day.

**Input:**

| field | type | required | notes |
|---|---|---|---|
| `transactionDate` | string | yes | YYYY-MM-DD. The single day to query. |
| `page` | int (≥1) | no | 1-based page number. Iyzico applies its own default if omitted. |
| `locale` | `"tr"` \| `"en"` | no | Response language. Default `"en"`. |

### `get_bin_info`

Look up bank/card metadata for the first 6-8 digits of a card number (the BIN). Returns issuer bank, card brand, card type (credit / debit / prepaid), and association.

**Input:**

| field | type | required | notes |
|---|---|---|---|
| `binNumber` | string | yes | 6 to 8 leading digits of the card number. |
| `locale` | `"tr"` \| `"en"` | no | Response language. Default `"en"`. |

### `get_installment_info`

List installment options Iyzico will allow for a given card BIN at a given price. Returns the installment schedule (1, 2, 3, 6, 9, 12 months) with per-installment pricing.

**Input:**

| field | type | required | notes |
|---|---|---|---|
| `binNumber` | string | yes | 6 to 8 leading digits of the card. |
| `price` | string | yes | Total price as a decimal string (e.g. `"1000"`, `"1000.50"`). |
| `locale` | `"tr"` \| `"en"` | no | Response language. Default `"en"`. |

### `get_subscription`

Retrieve an Iyzico subscription by its reference code. Returns subscription state (active/canceled/expired), pricing plan, customer reference, and billing schedule.

**Input:**

| field | type | required | notes |
|---|---|---|---|
| `subscriptionReferenceCode` | string | yes | Iyzico subscription reference code (returned at subscription creation, permanent ID). |
| `locale` | `"tr"` \| `"en"` | no | Response language. Default `"en"`. |

## Setup

### Install from source

```bash
git clone https://github.com/verepdev/iyzico-mcp
cd iyzico-mcp
bun install
bun run build
```

### Environment

Required:

- `IYZICO_API_KEY` — Iyzico API key.
- `IYZICO_SECRET_KEY` — Iyzico API secret.
- `IYZICO_BASE_URL` — `https://sandbox-api.iyzipay.com` (sandbox) or `https://api.iyzipay.com` (production). **No default** — set explicitly to avoid accidental production hits.

### Claude Desktop config

Edit `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "iyzico": {
      "command": "node",
      "args": ["/absolute/path/to/iyzico-mcp/dist/index.js"],
      "env": {
        "IYZICO_API_KEY": "sandbox-...",
        "IYZICO_SECRET_KEY": "sandbox-...",
        "IYZICO_BASE_URL": "https://sandbox-api.iyzipay.com"
      }
    }
  }
}
```

Restart Claude Desktop.

Other MCP clients (Cursor, cline) follow the same pattern with their own config formats.

## Local development

```bash
bun install
bun test          # unit tests
bun run lint      # Biome lint+format check
bun run format    # auto-format
bun run build     # build to dist/

# MCP Inspector — interactive UI for testing the server
npx @modelcontextprotocol/inspector node dist/index.js
```

## License

[MIT](LICENSE) — by [@verepdev](https://github.com/verepdev).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [verepdev](https://github.com/verepdev)
- **Source:** [verepdev/iyzico-mcp](https://github.com/verepdev/iyzico-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-verepdev-iyzico-mcp
- Seller: https://agentstack.voostack.com/s/verepdev
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.