{
  "schema_version": 1,
  "name": "FXIT Pages",
  "origin": "https://192168123.xyz",
  "client_version": "1.0.3",
  "instructions": "https://192168123.xyz/agent.md",
  "skill": "https://192168123.xyz/SKILL.md",
  "client": "https://192168123.xyz/client.py",
  "stdio_bridge": "https://192168123.xyz/mcp-stdio.py",
  "requirements": {
    "cli_python": ">=3.9",
    "codex_config_merge_python": ">=3.11",
    "agent": [
      "HTTPS",
      "local files",
      "terminal"
    ],
    "link_alone_grants_access": false
  },
  "authentication": {
    "type": "platform_device_approval_or_personal_key",
    "authorization_header": "Authorization: Bearer <portal-user-token>",
    "credential_storage": "User config directory; POSIX mode 0600; no credentials in project MCP config",
    "start": {
      "method": "POST",
      "path": "/v1/device/start",
      "body": {
        "agent": "display name"
      },
      "returns": [
        "device_code",
        "user_code",
        "verification_uri",
        "expires_in",
        "interval"
      ]
    },
    "poll": {
      "method": "POST",
      "path": "/v1/device/token",
      "body": {
        "device_code": "secret from private ticket"
      },
      "pending": {
        "http": 202,
        "status": "pending"
      },
      "authorized": {
        "http": 200,
        "status": "authorized",
        "token": "one-time delivery"
      },
      "expired_or_consumed": {
        "http": 410
      }
    },
    "device_lifetime_seconds": 600,
    "minimum_poll_interval_seconds": 3,
    "human_approval": "Open verification_uri and enter your own platform publishing key.",
    "universal_mcp_oauth": false
  },
  "install": {
    "project_only": true,
    "modifies_trust_settings": false,
    "clients": {
      "cursor": {
        "skill": ".cursor/skills/fxit-pages/SKILL.md",
        "mcp": ".cursor/mcp.json",
        "mode": "documented_config_generation"
      },
      "claude": {
        "skill": ".claude/skills/fxit-pages/SKILL.md",
        "mcp": ".mcp.json",
        "mode": "documented_config_generation"
      },
      "codex": {
        "skill": ".agents/skills/fxit-pages/SKILL.md",
        "mcp": ".codex/config.toml",
        "mode": "documented_config_generation",
        "trusted_project_required": true
      },
      "qoder": {
        "skill": ".fxit-pages/SKILL.md",
        "mcp": ".fxit-pages/mcp-config.json",
        "mode": "manual_generic_config"
      },
      "generic": {
        "skill": ".fxit-pages/SKILL.md",
        "mcp": ".fxit-pages/mcp-config.json",
        "mode": "manual_generic_config"
      }
    },
    "activation": "Client may require reload, server approval or project trust. CLI can publish before MCP activation.",
    "compatibility_note": "Configuration formats are based on client documentation; actual client versions are not all end-to-end verified."
  },
  "rest": {
    "me": {
      "method": "GET",
      "path": "/v1/me"
    },
    "list_sites": {
      "method": "GET",
      "path": "/v1/sites"
    },
    "get_site": {
      "method": "GET",
      "path": "/v1/sites/{slug}"
    },
    "deploy": {
      "method": "POST",
      "path": "/v1/sites/{slug}/deploy",
      "query": {
        "runtime": [
          "static",
          "node"
        ],
        "entry": "Node only; defaults to server.mjs; omit for static"
      },
      "content_type": "application/gzip",
      "accepted_http": 202,
      "response": "{site}",
      "completion": "Poll get_site until ready or error, then check site.url."
    }
  },
  "mcp": {
    "endpoint": "https://192168123.xyz/mcp",
    "transport": "streamable-http",
    "stateless": true,
    "json_response": true,
    "recommended_client_transport": "local stdio bridge with private profile",
    "tools": {
      "whoami": {
        "input": {}
      },
      "list_sites": {
        "input": {}
      },
      "get_site": {
        "input": {
          "slug": "string"
        }
      },
      "publish_site": {
        "input": {
          "slug": "string",
          "runtime": "static|node",
          "entry": "optional .mjs relative path",
          "files": "map of relative paths to UTF-8 text"
        },
        "max_total_utf8_bytes": 2097152
      },
      "stop_site": {
        "input": {
          "slug": "string"
        }
      }
    }
  },
  "deployment": {
    "slug": {
      "pattern": "^[a-z0-9](?:[a-z0-9-]{0,22}[a-z0-9])?$",
      "max_length": 24,
      "forbidden_substring": "--"
    },
    "statuses": [
      "queued",
      "deploying",
      "ready",
      "error",
      "stopped"
    ],
    "url_source": "site.url returned by API; reuse same user and slug for updates",
    "local_build_required": true,
    "server_dependency_install": false,
    "arbitrary_dockerfile": false,
    "arbitrary_compose": false,
    "user_supplied_server_environment": false,
    "single_replica": true,
    "resource_limits": {
      "memory_bytes": 134217728,
      "cpus": 0.35,
      "pids": 64,
      "tmp_bytes": 16777216,
      "node_max_old_space_mib": 80
    },
    "account_site_quota": {
      "source": "GET /v1/me maxSites",
      "default": 2,
      "unlimited_value": 0,
      "shared_by_all_account_keys": true,
      "lowering_quota_keeps_existing_sites_and_allows_updates": true
    },
    "max_active_site_slots": 0,
    "capacity_note": "Zero means no instance-wide site-count limit. Only the owner-configured account site quota applies to site counts; account maxSites=0 is unlimited. Active-site statistics are deployment records, not live container-health probes."
  },
  "runtimes": {
    "static": {
      "required_root_file": "index.html",
      "code_read_only": true
    },
    "node": {
      "image": "node:24-alpine",
      "platform": "linux/amd64",
      "libc": "musl",
      "entry_default": "server.mjs",
      "entry_suffix": ".mjs",
      "command": "node <entry>",
      "listen_host": "0.0.0.0",
      "env": {
        "PORT": "3000",
        "DATABASE_PATH": "/data/app.sqlite"
      },
      "code_read_only": true,
      "persistent_path": "/data",
      "persistence": "Retained across updates and stop",
      "recommended_dependencies": "bundled pure JavaScript and node:sqlite; native dependencies must match Linux amd64 musl"
    }
  },
  "archive": {
    "format": "tar.gz",
    "max_compressed_bytes": 33554432,
    "max_expanded_file_bytes": 67108864,
    "max_file_bytes": 33554432,
    "max_entries": 4096,
    "allowed_entries": [
      "regular_file",
      "directory"
    ],
    "rejected_entries": [
      "symlink",
      "hardlink",
      "special_file",
      "absolute_path",
      "parent_traversal",
      "duplicate_path"
    ],
    "client_excludes": [
      ".env*",
      ".git",
      "agent configs",
      "config",
      "credentials",
      "common private key files",
      "local database files"
    ],
    "note": "Exclusions are not a secret scanner; publish only reviewed build artifacts."
  },
  "official_client_references": [
    "https://cursor.com/docs/mcp",
    "https://cursor.com/docs/skills",
    "https://code.claude.com/docs/en/mcp",
    "https://code.claude.com/docs/en/skills",
    "https://learn.chatgpt.com/docs/extend/mcp?surface=cli",
    "https://learn.chatgpt.com/docs/build-skills"
  ]
}
