Iyzico Mcp

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

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:

{
  "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

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.

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
• Source: verepdev/iyzico-mcp
• License: MIT

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