---
title: İsimKayıt Agent Integration Guide
canonical: https://www.isimkayit.com/agents.md
html: https://www.isimkayit.com/for-agents
mcp: https://www.isimkayit.com/mcp
manifest: https://www.isimkayit.com/.well-known/mcp.json
openapi: https://www.isimkayit.com/.well-known/openapi.json
llms: https://www.isimkayit.com/llms.txt
protocol: 2024-11-05
version: 1.2.0
currency: TRY
commerce_phase: 1
commerce_enabled: true
---

# İsimKayıt Agent Integration Guide

> Official machine-readable guide for AI assistants, crawlers, and autonomous agents.
> Do not scrape HTML. Do not invent prices. Use MCP or the public JSON APIs.

## Quick Start

1. LLM profile: https://www.isimkayit.com/llms.txt
2. Full catalog context: https://www.isimkayit.com/llms-full.txt
3. OpenAPI: https://www.isimkayit.com/.well-known/openapi.json
4. AI plugin: https://www.isimkayit.com/.well-known/ai-plugin.json
5. MCP manifest: https://www.isimkayit.com/.well-known/mcp.json
6. Commerce: https://www.isimkayit.com/.well-known/commerce.json
7. AI sitemap: https://www.isimkayit.com/sitemap-ai.xml
8. Human hub: https://www.isimkayit.com/for-agents

## Protocol

- **HTTP MCP:** `POST https://www.isimkayit.com/mcp?lang=tr`
- **JSON-RPC 2.0 methods:** `initialize`, `tools/list`, `tools/call`, `ping`
- **Protocol version:** 2024-11-05
- **stdio:** `node/mcp-server` with `ISIMKAYIT_BASE_URL=https://www.isimkayit.com`
- **CORS:** `*` on GET/POST/OPTIONS `/mcp` and discovery documents
- **Currency:** TRY (TL). KDV %20 is added at browser checkout unless stated.

```
POST https://www.isimkayit.com/mcp?lang=tr
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"agent","version":"1.0"}}}
```

## API Base URL

- **Canonical:** https://www.isimkayit.com/api
- Language prefix `/tr/api` is accepted; the public site default is Turkish without a prefix.

## Recommended Flows

### Domain registration

1. `POST https://www.isimkayit.com/api/search_domain` with `{ "domain": "example.com.tr" }` — use `available`, `register_1y`, `prices.register` (TRY). Ignore raw WHMCS `price` map if present.
2. For ccTLDs (.tr etc.): `GET https://www.isimkayit.com/api/agent_domain_fields?tld=tr`
3. `POST https://www.isimkayit.com/api/agent_cart_add` with `{ "domain": "example.com.tr", "additional_fields": { ... } }`
4. Open `checkout_url` (24h TTL) — the human pays in the browser

### Hosting / VDS / SSL / Email / VPN

1. `GET https://www.isimkayit.com/api/agent_catalog?type=hosting` (`cloudserver`, `ssl`, `kurumsalmail`, `vpn`, `all`)
2. Use `product_id`, `landing_url`, `purchase_url`, `billing_periods` (live WHMCS TRY)
3. `POST https://www.isimkayit.com/api/agent_cart_add` with `{ "product_id": 23, "billing_cycle": "monthly" }`
4. Optional: `POST https://www.isimkayit.com/api/agent_checkout_quote` → 15-minute locked quote
5. Phase 1: open `checkout_url` — never collect PAN / CVV inside the agent

### WHOIS / recommendations

- `POST https://www.isimkayit.com/api/whois` — registrar, expiry, nameservers
- `POST https://www.isimkayit.com/api/ai_suggest` — domain name ideas
- MCP `recommend_server` — VDS/cloud plan from a workload description

## Public API Endpoints

- `https://www.isimkayit.com/api/ping`
- `https://www.isimkayit.com/api/tlds`
- `https://www.isimkayit.com/api/top_tlds`
- `https://www.isimkayit.com/api/search_domain`
- `https://www.isimkayit.com/api/whois`
- `https://www.isimkayit.com/api/list_products/{type}`
- `https://www.isimkayit.com/api/agent_catalog?type=`
- `https://www.isimkayit.com/api/ai_suggest`
- `https://www.isimkayit.com/api/agent_domain_fields`
- `https://www.isimkayit.com/api/agent_cart_add`
- `https://www.isimkayit.com/api/agent_cart/{cart_id}`
- `https://www.isimkayit.com/api/agent_checkout_quote`
- `https://www.isimkayit.com/api/infrastructure_status`

## MCP Tools

- `list_products` — List live hosting, VDS, SSL, email, VPN, SLA or Sophos products with TRY prices, landing_url and purchase_url. (`GET /api/agent_catalog?type={type}`)
- `list_tlds` — List supported TLD extensions with live registration, renewal and transfer prices in TRY. (`GET /api/tlds`)
- `search_domain` — Check if a domain is available for registration and return live TRY pricing for the TLD. (`POST /api/search_domain`)
- `whois_lookup` — WHOIS lookup for a registered domain (registrar, expiry, nameservers). (`POST /api/whois`)
- `recommend_server` — Recommend a live VDS/cloud plan from a plain-language workload and return best_pid from list_products. (`POST /api/ai_server_suggest (fallback: live catalog heuristic)`)
- `ai_domain_suggest` — Generate brandable domain name ideas from a business description and check availability. (`POST /api/ai_suggest`)
- `agent_domain_fields` — WHMCS additional fields for ccTLDs (.tr etc.) required before agent_cart_add. (`GET /api/agent_domain_fields?tld=`)
- `agent_cart_add` — Add a product or domain to an agent cart and receive checkout_url (24h TTL) for browser handoff. (`POST /api/agent_cart_add`)
- `agent_cart_get` — Get summary of an existing agent cart by cart_id (items, subtotal, checkout_url, TTL). (`GET /api/agent_cart/{cart_id}`)
- `agent_checkout_quote` — Create a 15-minute locked price quote from an agent cart and return checkout_url. (`POST /api/agent_checkout_quote`)
- `get_status` — Live infrastructure status (Kocaeli DC uptime, ping, BGP links) from the public transparency API. (`GET /api/infrastructure_status`)

## Buy hosting via MCP

1. `tools/call` → `list_products` `{ "type": "hosting" }`
2. Pick `product_id` + `billing_cycle` (live TRY)
3. `tools/call` → `agent_cart_add` `{ "product_id": N, "billing_cycle": "monthly" }`
4. Return `checkout_url` to the user (cart TTL 24h)

## Agent Checkout (Phase 1)

- **Manifest:** https://www.isimkayit.com/.well-known/commerce.json
- **Master switch:** `AGENT_COMMERCE_ENABLED` — currently `true`
- When `false`, WRITE tools return HTTP 503 `agent_commerce_disabled`; discovery stays up
- **Mode:** browser handoff — no PAN capture in MCP
- **Health:** `GET https://www.isimkayit.com/api/ping` · `GET https://www.isimkayit.com/.well-known/mcp.json`

## Partner keys

Registered agents can request higher rate limits.

- **Header:** `Authorization: Bearer …` or `X-Agent-Api-Key: …`
- **Contact:** destek@isimkayit.com

| Tier | WHOIS / 60s | AI / hour | agent_cart / hour |
|------|-------------|-----------|-------------------|
| Public (no key) | 5 | 15 | 10 |
| Partner agent | 15 | 45 | 30 |
| Enterprise agent | 50 | 150 | 100 |

On **429**: `Retry-After`, `X-RateLimit-*`, JSON `retry_after`.

## Trust

- TRABİS authorized .tr registrar · BTK 5651 hosting provider · ETBİS
- Own Tier II DC (Kocaeli) · AS202536 · PeeringDB
- Support: 0850 290 33 44 · destek@isimkayit.com
- Privacy / KVKK: https://www.isimkayit.com/kvkk · Contracts: https://www.isimkayit.com/sozlesmeler · Transparency: https://www.isimkayit.com/seffaflik

Generated: 2026-08-14T00:08:13+03:00
Language: tr