{
  "format": "vobarna-webmcp-reference",
  "schema_version": 1,
  "name": "VO Barna",
  "description": "Browser tools for finding original-version cinema screenings around Barcelona, inspecting collected film and session details, and showing official booking links.",
  "documentation": "/webmcp/",
  "execution": {
    "page": "/en/",
    "pages": [
      "/en/",
      "/es/",
      "/ca/"
    ],
    "interface": "WebMCP",
    "registration_api": "document.modelContext.registerTool",
    "requires": [
      "JavaScript",
      "a WebMCP-capable browser agent",
      "a loaded programme"
    ]
  },
  "tools": [
    {
      "name": "get_context",
      "description": "Read VO Barna’s current view, supported cinemas and formats, programme coverage and data freshness.",
      "inputSchema": {
        "type": "object",
        "properties": {},
        "required": [],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "search_screenings",
      "description": "Find upcoming original-version screenings in VO Barna’s collected Barcelona-area programme. Returns paginated sessions with film and screening IDs, cached availability and official booking links. Leaves the page unchanged. Omitted filters mean all screenings.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 500,
            "description": "Film titles, people, genres, languages, countries, cinemas, formats or natural-language dates in English, Spanish or Catalan. Language names also match production nationality. Examples: \"Villeneuve this weekend\", \"espanol IMAX\", \"French tomorrow\"."
          },
          "date_from": {
            "type": [
              "string",
              "null"
            ],
            "description": "Inclusive first screening date, YYYY-MM-DD, in Europe/Madrid. Explicit dates override dates in query."
          },
          "date_to": {
            "type": [
              "string",
              "null"
            ],
            "description": "Inclusive last screening date, YYYY-MM-DD, in Europe/Madrid. Use the same date_from and date_to for one day."
          },
          "cinema_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "description": "Match any of these cinema IDs from get_context. Empty means all cinemas."
          },
          "formats": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "description": "Require every listed format on the same screening. Use format values from get_context."
          },
          "big_screens_only": {
            "type": "boolean",
            "description": "Use the curated premium selection, including comfort-focused venues."
          },
          "limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 50,
            "default": 20,
            "description": "Maximum number of sessions to return."
          },
          "offset": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100000,
            "default": 0,
            "description": "Result offset; use next_offset to continue. Results are ordered by start time, then screening ID."
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "get_film",
      "description": "Read a film’s collected credits, original languages, release information and ratings with source URLs and observation dates.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "film_id": {
            "type": "string",
            "maxLength": 256,
            "description": "Exact film_id returned by search_screenings."
          }
        },
        "required": [
          "film_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "get_screening",
      "description": "Read one screening’s room, format, observed price, cached seat counts and official booking destination. Availability includes its timestamp, count kind and staleness.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "screening_id": {
            "type": "string",
            "maxLength": 256,
            "description": "Exact screening_id returned by search_screenings."
          }
        },
        "required": [
          "screening_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": true,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "set_search",
      "description": "Replace the visible VO Barna search and filters, close the film dialog, and update results and the shareable URL. Returns the first 20 matching sessions. Omitted filters are cleared; empty arguments reset the search.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 500,
            "description": "Film titles, people, genres, languages, countries, cinemas, formats or natural-language dates in English, Spanish or Catalan. Language names also match production nationality. Examples: \"Villeneuve this weekend\", \"espanol IMAX\", \"French tomorrow\"."
          },
          "date_from": {
            "type": [
              "string",
              "null"
            ],
            "description": "Inclusive first screening date, YYYY-MM-DD, in Europe/Madrid. Explicit dates override dates in query."
          },
          "date_to": {
            "type": [
              "string",
              "null"
            ],
            "description": "Inclusive last screening date, YYYY-MM-DD, in Europe/Madrid. Use the same date_from and date_to for one day."
          },
          "cinema_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "description": "Match any of these cinema IDs from get_context. Empty means all cinemas."
          },
          "formats": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "description": "Require every listed format on the same screening. Use format values from get_context."
          },
          "big_screens_only": {
            "type": "boolean",
            "description": "Use the curated premium selection, including comfort-focused venues."
          }
        },
        "required": [],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    },
    {
      "name": "show_screening",
      "description": "Open an upcoming screening in the film dialog and highlight its official ticket link. Updates the shareable URL. If current filters hide this screening, the dialog shows the film’s upcoming sessions. The ticket link leads to the cinema’s booking flow.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "screening_id": {
            "type": "string",
            "maxLength": 256,
            "description": "Exact screening_id returned by search_screenings."
          }
        },
        "required": [
          "screening_id"
        ],
        "additionalProperties": false
      },
      "annotations": {
        "readOnlyHint": false,
        "untrustedContentHint": true,
        "consequentialHint": false
      }
    }
  ]
}
