Skip to main content
Glama
Sign In
vic-au-important-dates-mcp

vic-au-important-dates-mcp

by ivarrian
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Victoria Important Dates MCP

A Model Context Protocol (MCP) server that provides access to Victoria, Australia's important dates and holidays API.

The API is documented here

Features

  • Access to Victoria, Australia public holidays and important dates

  • MCP-compatible server implementation

  • Easy integration with MCP clients

  • RESTful API wrapper for Victoria government data

Related MCP server: swiss-school-calendar-mcp

Installation

pip install vic-au-important-dates-mcp

Usage

Running the MCP Server

After installation, you can run the MCP server directly:

vic-au-dates-mcp-server

Or using uv:

uv run vic-au-dates-mcp-server

Direct API Usage

from vic_au_important_dates_mcp.client import VictoriaImportantDatesClient

# Create a client instance
client = VictoriaImportantDatesClient()

# Get holidays for a specific year
holidays = client.get_holidays(2024)

# Get holidays for a specific date range
holidays = client.get_holidays_range("2024-01-01", "2024-12-31")

Configuration

The package uses environment variables for configuration:

  • DEVELOPER_VIC_GOV_AU_KEY:

  • DEVELOPER_VIC_GOV_AU_SECRET:

  • BASE_URL (The current known URL is https://wovg-community.gateway.prod.api.vic.gov.au/vicgov/v2.0/ and is subject to change in the future )

Register at [developer.vic.gov.au][https://developer.vic.gov.au] to get your developer key/secret

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues and questions, please use the GitHub issues page.

Available Tools

1 tool
get_datesA

Get a list of important dates for the state of Victoria, Australia.

Args:
    from_date: From date in the format YYYY-MM-DD
    to_date: To date in the format YYYY-MM-DD
    type: can be one of PUBLIC_HOLIDAY,DAYLIGHT_SAVING,SCHOOL_TERM,SCHOOL_HOLIDAY,FLAG_NOTIFICATION,PARLIAMENT_SITTING,MULTI_FAITH

Inputs: from_date (required), to_date (required), type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.3/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion between tools. The single tool's purpose is clearly defined.

    Naming Consistency5/5

    With a single tool, there is no pattern to assess inconsistency. The name 'get_dates' follows a clear verb_noun structure.

    Tool Count3/5

    The server has only one tool, which is at the low end of typical scoping. While the tool covers many date types via parameters, a slightly larger set (e.g., separate tools for each type) might be more intuitive, but it remains functional.

    Completeness5/5

    The tool fully covers the stated domain of important dates for Victoria, Australia, supporting all listed date types (public holidays, daylight saving, school terms, etc.) with flexible date filtering. No obvious gaps exist for a read-only query service.

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-nager-holidays

      pipeworx-io
      A
      license
      Not graded
      quality
      F
      maintenance
      MCP server for accessing Nager.Date public holidays data. It provides tools to query and retrieve holiday information for various countries through natural language or direct tool calls.
      8 npm
      MIT

    • Receita Federal: Agenda

      mcp-dir
      A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for consulting the Brazilian Federal Revenue tax calendar (Agenda Tributária) from the official source. Provides a read-only tool to query tax schedule information via natural language in any MCP-compatible client.
      MIT