{
  "openapi": "3.1.0",
  "info": {
    "title": "timenowin.ai API",
    "version": "1.0.0",
    "description": "Atomic-synced world clock. Machine-readable time, sun, moon, DST, holidays, and city metadata for any of ~250 supported cities and any IANA timezone.",
    "contact": {
      "name": "timenowin.ai",
      "url": "https://timenowin.ai"
    },
    "license": {
      "name": "Open data",
      "url": "https://timenowin.ai"
    }
  },
  "servers": [
    {
      "url": "https://timenowin.ai",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/now": {
      "get": {
        "summary": "Current synchronized time",
        "operationId": "getNow",
        "parameters": [
          {
            "name": "tz",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "example": "Europe/London"
            },
            "description": "IANA timezone"
          }
        ],
        "responses": {
          "200": {
            "description": "Current time",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "iso": {
                      "type": "string"
                    },
                    "unix_ms": {
                      "type": "integer"
                    },
                    "tz": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/location/{slug}": {
      "get": {
        "summary": "Full location dossier",
        "operationId": "getLocation",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "Tehran"
            },
            "description": "City slug, IANA zone, or country name"
          }
        ],
        "responses": {
          "200": {
            "description": "Location time, sun, moon, DST, holidays, neighbors",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "404": {
            "description": "Slug not resolvable to a known location"
          }
        }
      }
    }
  },
  "components": {},
  "x-ai-discovery": {
    "mcp_endpoint": "https://timenowin.ai/api/mcp",
    "mcp_transport": "streamable-http",
    "agent_card": "/.well-known/agent.json",
    "mcp_manifest": "/.well-known/mcp.json",
    "llms_txt": "/llms.txt",
    "agents_md": "/agents.md",
    "sitemap": "/sitemap.xml"
  }
}