{
  "kind": "swipies.agent-access.discovery",
  "version": "1.0.0",
  "name": "Swipies Agent Access",
  "description": "External AI clients manage tenant resources through MCP and authenticated APIs. Swipies does not host the external assistant.",
  "api_base_url": "https://api.swipies.app",
  "runtime_manifest": "https://api.swipies.app/api/v1/agent-access/manifest",
  "documentation": "https://swipies.app/agents.html",
  "instructions": "https://swipies.app/llms-full.txt",
  "openapi": "https://swipies.app/agent-access.openapi.json",
  "mcp": {
    "url": "https://api.swipies.app/api/v1/agent-access/mcp",
    "transport": "streamable-http",
    "protocol_version": "2025-03-26",
    "http_method": "POST",
    "authentication": "bearer-api-key",
    "user_agent": "SwipiesAgent/1.0",
    "tools": [
      "swipies_list_operations",
      "swipies_describe_operation",
      "swipies_execute"
    ]
  },
  "stdio_client": {
    "download": "https://swipies.app/downloads/swipies_agent_client.py.txt",
    "save_as": "swipies_agent_client.py",
    "python": ">=3.10",
    "dependencies": [],
    "automatic_free_service_account": true,
    "existing_account_api_key_environment_variable": "SWIPIES_API_KEY"
  },
  "bootstrap": {
    "url": "https://api.swipies.app/api/v1/agent-access/bootstrap",
    "method": "POST",
    "authentication": "persisted locally generated registration_secret",
    "registration_secret_generation": "secrets.token_urlsafe(32)",
    "account_plan": "free",
    "reconnect": "Reuse the same locally persisted secret; do not register a new account per request.",
    "client_requirements": "Authorized HTTPS POST and private durable storage; no preconfigured MCP connector is required."
  },
  "operations": {
    "url": "https://api.swipies.app/api/v1/agent-access/operations",
    "authentication": "bearer-api-key",
    "discovery_required": true,
    "operation_ids": "Discover at runtime; never guess or hardcode them."
  },
  "capabilities": [
    "agents and chatbots",
    "datasets and documents",
    "multipart uploads and parsing jobs",
    "retrieval and RAG",
    "available model configuration",
    "available channel configuration",
    "authorized source connectors",
    "tenant-scoped resource management"
  ],
  "boundaries": [
    "Use existing authorized HTTPS/code tools directly; host MCP installation is optional for this path. A documentation URL cannot add tools to a webpage-reading-only session.",
    "Existing customers use their existing account API key or approved owner OAuth connection when enabled; a new Free workspace does not inherit that tenant or subscription.",
    "Private databases, providers and OAuth services require valid authorized credentials.",
    "Admin operations, payments, token management and Ads are not exposed by the current generic MCP catalog.",
    "Client permissions, account authorization, subscription quotas and registration rate limits remain in force.",
    "After an ambiguous write timeout, inspect state before retrying."
  ],
  "branding": {
    "default": "required",
    "removal_plans": [
      "plus",
      "pro"
    ],
    "requires_active_persisted_subscription": true
  },
  "limits": {
    "request_bytes": 25165824,
    "multipart_total_bytes": 16777216,
    "multipart_file_count": 20,
    "result_bytes": 8388608,
    "operation_timeout_seconds": 90
  },
  "verified_on": "2026-10-27",
  "verified_scope": [
    "MCP stdio and HTTP",
    "resource CRUD",
    "document parsing and retrieval",
    "RAG references",
    "OpenAI-compatible nonstream and streaming replies",
    "Free and Pro attribution",
    "tenant isolation"
  ],
  "not_live_verified": [
    "actual external CRM delivery",
    "paid advertising delivery"
  ],
  "client_setup": {
    "url": "https://swipies.app/agents.html#swipies-setup",
    "clients": [
      "codex",
      "claude-code",
      "cursor"
    ],
    "terminals": [
      "windows-powershell",
      "posix-shell"
    ],
    "collects_credentials": false,
    "installs_automatically": false
  },
  "preferred_access": {
    "mode": "direct-https-bootstrap",
    "requires_host_mcp_installation": false,
    "requires": "Authorized HTTPS request tools or code with network access and private durable credential storage.",
    "account_selection": "Reuse authorized existing-account credentials for existing resources; bootstrap only a new separate Free workspace.",
    "sequence": [
      "read_manifest",
      "persist_random_registration_secret",
      "bootstrap_or_reconnect",
      "initialize_mcp_over_https",
      "discover_tools_and_operations",
      "describe_then_execute",
      "verify_results"
    ],
    "instructions": "https://swipies.app/llms-full.txt",
    "no_api_tools": "A webpage URL cannot install tools or grant account access in the AI host."
  },
  "documentation_updated_on": "2026-10-28",
  "direct_https_verification": {
    "date": "2026-10-28",
    "checks_passed": 17,
    "scope": [
      "new isolated Free registration without preconfigured MCP or key",
      "identity persistence and reconnect",
      "operation discovery",
      "dataset creation and document upload",
      "parsing to completion",
      "agent execution",
      "chatbot answer with document references",
      "Free attribution"
    ],
    "disposable_resources_removed": true,
    "client_environment": "Python code making ordinary HTTPS requests; no host MCP installation used"
  },
  "oauth": {
    "availability": "Check runtime_manifest: mcp.oauth.enabled must be true; disabled by default.",
    "mcp_url": "https://api.swipies.app/api/v1/agent-access/mcp",
    "resource_metadata": "https://api.swipies.app/.well-known/oauth-protected-resource/api/v1/agent-access/mcp",
    "authorization_server_metadata": "https://api.swipies.app/.well-known/oauth-authorization-server",
    "flow": "authorization_code",
    "pkce": "S256",
    "token_endpoint_auth_method": "none",
    "initial_supported_client": "ChatGPT",
    "scopes": [
      "swipies:read",
      "swipies:write",
      "offline_access"
    ],
    "consent_choices": [
      "new separate Free workspace",
      "current logged-in owner account"
    ],
    "requires_host_connection_and_user_consent": true,
    "guide": "https://swipies.app/agents.html#chatgpt",
    "verification": "Implemented locally; actual ChatGPT connection verification is pending."
  }
}