{
  "openapi": "3.0.3",
  "info": {
    "title": "MCP Server",
    "description": "Ideasoft MCP (Model Context Protocol) sunucusu; AI araçlarının mağaza API'lerine erişimini sağlar. Streamable HTTP transport kullanır ve durumsuzdur.\n\nThe Ideasoft MCP (Model Context Protocol) server; gives AI tools access to the store APIs. Uses the Streamable HTTP transport and is stateless.",
    "version": "1.0.0",
    "x-generated-by": "tools/mcp-sync.mjs",
    "x-mcp-tool-count": 16
  },
  "servers": [
    {
      "url": "https://mcp.myideasoft.com"
    }
  ],
  "paths": {
    "/mcp": {
      "post": {
        "operationId": "mcp_endpoint",
        "security": [],
        "summary": "MCP JSON-RPC endpoint",
        "description": "Streamable HTTP JSON-RPC endpoint. Send a JSON-RPC 2.0 request (e.g. tools/list, tools/call). The `security` header (`<store-domain>,<access-token>`) is required only for the `callApi` tool.",
        "x-zudoku-playground-enabled": false,
        "x-mcp-server": {
          "name": "ideasoft-mcp",
          "url": "https://mcp.myideasoft.com/mcp",
          "security": [
            {
              "security_header": []
            }
          ],
          "securitySchemes": {
            "security_header": {
              "type": "apiKey",
              "in": "header",
              "name": "security",
              "description": "\"<store-domain>,<access-token>\" — required only for callApi"
            }
          },
          "tools": [
            {
              "name": "getCurrentDateTime",
              "description": "Sistemdeki güncel tarihi döndürür. Dönüş formatı: DD-MMM-YYYY HH:mm:ss şeklindedir. \nÖrnek dönüş: \"25-Mar-2024 14:30:45\"\n\nBu tool özellikle:\n1. Tarih bazlı filtrelemeler yaparken\n2. Geçmiş/gelecek tarih hesaplamalarında (örn: geçen ay, gelecek hafta)\n3. Zaman damgası gerektiren işlemlerde\nkullanılmalıdır.\n\nNot: Dönüş değeri her zaman UTC+3 (Türkiye) zaman dilimindedir.",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "callApi",
              "description": "İlgili api hangisi olduğu tespit edilerek query yada body bilgileri öğrenilmelidir. Bu tool, tüm ideasoft panelini yada web sitesini yönetmek için çalıştırılacak dinamik api request'idir. Örn: /admin-api/{subject}...",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "İstek atılacak endpoint. Domain içermemeli ve sadece \"/\" ile başlamalı. Örn: /admin-api/..."
                  },
                  "method": {
                    "type": "string",
                    "description": "HTTP methodu (GET, POST, PUT, DELETE) - büyük/küçük harf duyarsızdır. PATCH yerine PUT kullanılmalıdır."
                  },
                  "query": {
                    "description": "ilgili tool kullanılarak query verilerinin ne olduğunu öğreneceksin. Genelde filtrelemek için kullanılır.Eğer tarih ile ilgili bir filtreleme yapacaksan önce bir sistemin tarihinin ne olduğunu öğrenmen lazım. Bunun için de 'getCurrentDateTime' tool'unu kullanacaksın.",
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {}
                  },
                  "body": {
                    "description": "ilgili tool kullanılarak query verilerinin ne olduğunu öğreneceksin. GET dışındaki methodlar için kullanılır.Eğer tarih ile ilgili bir veri ekleyeceksen önce bir sistemin tarihinin ne olduğunu öğrenmen lazım. Bunun için de 'getCurrentDateTime' tool'unu kullanacaksın.",
                    "type": "object",
                    "propertyNames": {
                      "type": "string"
                    },
                    "additionalProperties": {}
                  }
                },
                "required": [
                  "url",
                  "method"
                ]
              }
            },
            {
              "name": "getCatalogApiParams",
              "description": "Katalog kategorisi API'lerinin parametrelerini getirir (Ürünler, Kategoriler, Markalar, Özellikler).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getOrderApiParams",
              "description": "Sipariş kategorisi API'lerinin parametrelerini getirir (Siparişler, Sepetler, Fatura Adresleri).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getMemberApiParams",
              "description": "Üye kategorisi API'lerinin parametrelerini getirir (Müşteriler, Üye Grupları, Müşteri Adresleri).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getPaymentApiParams",
              "description": "Ödeme kategorisi API'lerinin parametrelerini getirir (Ödemeler, Ödeme Sağlayıcıları, Bankalar).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getShippingApiParams",
              "description": "Kargo kategorisi API'lerinin parametrelerini getirir (Kargolar, Kargo Şirketleri).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getCampaignApiParams",
              "description": "Kampanya kategorisi API'lerinin parametrelerini getirir (Kuponlar, İndirimler, Kampanyalar).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getContentApiParams",
              "description": "İçerik kategorisi API'lerinin parametrelerini getirir (Bloglar, Sayfalar, Bannerlar).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getStoreApiParams",
              "description": "Mağaza kategorisi API'lerinin parametrelerini getirir (Mağaza Ayarları, Checkout Tasarımı).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getUserApiParams",
              "description": "Kullanıcı kategorisi API'lerinin parametrelerini getirir (Kullanıcılar, Roller, İzinler).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getReadOnlyApiParams",
              "description": "Okuma kategorisi API'lerinin parametrelerini getirir (Sadece GET methodları).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getReportApiParams",
              "description": "Rapor kategorisi API'lerinin parametrelerini getirir (Raporlar, Analizler yada İstatistikler şeklinde istenmediği sürece bunu kullanma).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getLocationApiParams",
              "description": "Konum kategorisi API'lerinin parametrelerini getirir (Şehirler, İlçeler, Kargo Bölgeleri).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getNewsletterApiParams",
              "description": "Mail Listesi kategorisi API'lerinin parametrelerini getirir (Newsletter, E-posta Kampanyaları).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            },
            {
              "name": "getPaymentGatewayApiParams",
              "description": "Ödeme Altyapıları kategorisi API'lerinin parametrelerini getirir (Payment Gateway'ler, BDDK Kategorileri).",
              "inputSchema": {
                "$schema": "http://json-schema.org/draft-07/schema#",
                "type": "object",
                "properties": {}
              }
            }
          ]
        },
        "parameters": [
          {
            "name": "security",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "\"<store-domain>,<access-token>\" — required only for the callApi tool."
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "jsonrpc",
                  "id",
                  "method"
                ],
                "properties": {
                  "jsonrpc": {
                    "type": "string",
                    "enum": [
                      "2.0"
                    ]
                  },
                  "id": {},
                  "method": {
                    "type": "string"
                  },
                  "params": {
                    "type": "object"
                  }
                }
              },
              "example": {
                "jsonrpc": "2.0",
                "id": 1,
                "method": "tools/list",
                "params": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC response (SSE stream or JSON).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "jsonrpc": {
                      "type": "string"
                    },
                    "id": {},
                    "result": {},
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "integer"
                        },
                        "message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
