{
  "name": "Owning",
  "description": "Classifieds portal — buy and sell new and second-hand items",
  "documentation_url": "https://github.com/supertowers/owning/tree/main/docs",
  "api": {
    "base_url": "https://owning.pro/api",
    "version": "v1",
    "endpoints": {
      "listings": "/api/listings",
      "listing": "/api/listings/{id}",
      "listing_markdown": "/api/listings/{id}.md",
      "categories": "/api/categories",
      "asset_types": "/api/asset-types",
      "schema": "/api/schema/listing",
      "api_schema": "/api/schema",
      "auth": "/api/auth",
      "auth_register": "/api/auth/register",
      "auth_login": "/api/auth/login",
      "me": "/api/me",
      "api_keys": "/api/api-keys",
      "messaging": "/api/conversations",
      "contact_seller": "/api/listings/{id}/contact",
      "upload": "/api/upload",
      "interactive_docs": "/api/docs",
      "openapi_spec": "/api/openapi.json"
    },
    "auth": {
      "type": "api_key",
      "header": "Authorization",
      "prefix": "Bearer",
      "key_prefix": "own_",
      "permissions": [
        "read",
        "write",
        "admin"
      ],
      "docs": "/api/schema/listing.md",
      "note": "Public read endpoints (GET) require no auth. Write operations require authentication."
    },
    "rate_limits": {
      "public": {
        "requests": 200,
        "window_seconds": 60,
        "scope": "per IP address"
      },
      "authenticated": {
        "requests": 300,
        "window_seconds": 60,
        "scope": "per API key or user"
      },
      "headers": [
        "X-RateLimit-Limit",
        "X-RateLimit-Remaining",
        "X-RateLimit-Reset"
      ]
    },
    "mcp": {
      "url": "https://mcp.owning.pro/mcp",
      "protocol": "json-rpc-2.0",
      "transport": "streamable-http",
      "tools": [
        "search_listings",
        "get_listing",
        "get_listing_markdown",
        "list_categories",
        "get_asset_type",
        "create_listing",
        "upload_image",
        "publish_listing",
        "contact_seller",
        "manage_listing"
      ],
      "docs": "https://github.com/supertowers/owning/blob/main/docs/mcp-quickstart.md"
    }
  },
  "formats": [
    "json",
    "markdown"
  ]
}