{
  "schema_version": "1.0",
  "name": "Bankemes",
  "description": "Kaspi Pay acceptance for websites and apps (Kazakhstan) with guided onboarding for AI agents.",
  "documentation": "https://bankemes.kz/for-agents",
  "start_here": "https://bankemes.kz/for-agents/start.md",
  "agent_brief": "https://bankemes.kz/BANKEMES_AGENT.md",
  "skill": "https://bankemes.kz/SKILL.md",
  "llms_txt": "https://bankemes.kz/llms.txt",
  "openapi": "https://bankemes.kz/openapi.json",
  "mcp": {
    "url": "https://bankemes.kz/mcp",
    "transport": "streamable-http",
    "protocol_versions": [
      "2025-06-18",
      "2025-03-26",
      "2024-11-05"
    ],
    "auth": {
      "setup_key": {
        "header": "Authorization: Bearer bms_agent_…",
        "obtain": "https://bankemes.kz/agents"
      },
      "oauth": {
        "authorization_server_metadata": "https://bankemes.kz/.well-known/oauth-authorization-server",
        "protected_resource_metadata": "https://bankemes.kz/.well-known/oauth-protected-resource/mcp",
        "pkce": "S256"
      }
    },
    "scopes": [
      "onboarding:read",
      "onboarding:write",
      "integration:write",
      "test:write"
    ],
    "first_tool": "bankemes_get_next_setup_action",
    "tools": [
      {
        "name": "bankemes_get_next_setup_action",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_setup_status",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_account",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_dashboard_link",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_subscription_status",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_subscription_payment_link",
        "scope": "onboarding:write"
      },
      {
        "name": "bankemes_list_cashiers",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_cashier_status",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_start_cashier_connection",
        "scope": "onboarding:write"
      },
      {
        "name": "bankemes_check_cashier_connection",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_create_resource",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_list_resources",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_provision_integration",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_configure_webhook",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_get_integration_guide",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_integration_status",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_create_test_payment",
        "scope": "test:write"
      },
      {
        "name": "bankemes_simulate_test_payment",
        "scope": "test:write"
      },
      {
        "name": "bankemes_get_test_payment",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_verify_test_webhook",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_create_payment_link",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_list_payment_links",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_list_customers",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_create_customer",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_get_customer",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_update_customer",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_archive_customer",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_list_recurring_invoices",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_recurring_invoice",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_manage_recurring_invoice",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_create_bulk_invoices",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_get_payment_analytics",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_diagnose_webhooks",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_configure_integration",
        "scope": "integration:write"
      },
      {
        "name": "bankemes_get_installation_status",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_get_sdk_guide",
        "scope": "onboarding:read"
      },
      {
        "name": "bankemes_verify_sandbox_scenarios",
        "scope": "onboarding:read"
      }
    ]
  },
  "workflows": [
    {
      "id": "connect-payments",
      "title": "Workflow: subscription payment",
      "url": "https://bankemes.kz/for-agents/workflows/connect-payments",
      "markdown": "https://bankemes.kz/for-agents/workflows/connect-payments.md"
    },
    {
      "id": "connect-cashier",
      "title": "Workflow: Kaspi cashier",
      "url": "https://bankemes.kz/for-agents/workflows/connect-cashier",
      "markdown": "https://bankemes.kz/for-agents/workflows/connect-cashier.md"
    },
    {
      "id": "setup-project",
      "title": "Workflow: set up the project",
      "url": "https://bankemes.kz/for-agents/workflows/setup-project",
      "markdown": "https://bankemes.kz/for-agents/workflows/setup-project.md"
    },
    {
      "id": "test-integration",
      "title": "Workflow: test the integration",
      "url": "https://bankemes.kz/for-agents/workflows/test-integration",
      "markdown": "https://bankemes.kz/for-agents/workflows/test-integration.md"
    },
    {
      "id": "merchant-subscriptions",
      "title": "Workflow: seller-managed buyer subscriptions",
      "url": "https://bankemes.kz/for-agents/workflows/merchant-subscriptions",
      "markdown": "https://bankemes.kz/for-agents/workflows/merchant-subscriptions.md"
    }
  ],
  "setup_states": [
    {
      "state": "manual_review_required",
      "actor": "bankemes"
    },
    {
      "state": "subscription_required",
      "actor": "customer"
    },
    {
      "state": "subscription_payment_pending",
      "actor": "customer"
    },
    {
      "state": "cashier_connection_required",
      "actor": "customer"
    },
    {
      "state": "cashier_connection_pending",
      "actor": "customer"
    },
    {
      "state": "cashier_reconnection_required",
      "actor": "customer"
    },
    {
      "state": "project_access_required",
      "actor": "customer"
    },
    {
      "state": "resource_setup_required",
      "actor": "agent"
    },
    {
      "state": "integration_configuration_required",
      "actor": "agent"
    },
    {
      "state": "sandbox_verification_required",
      "actor": "agent"
    },
    {
      "state": "owner_approval_required",
      "actor": "customer"
    },
    {
      "state": "ready",
      "actor": "customer"
    }
  ],
  "environment_variables": [
    "BANKEMES_TEST_API_TOKEN",
    "BANKEMES_API_TOKEN",
    "BANKEMES_WEBHOOK_SECRET"
  ]
}
