get_hours_of_operation
Retrieve operating hours for DevHub CMS locations, showing daily schedules including multiple time ranges for breaks and closed days.
Instructions
Get the hours of operation for a DevHub location
Returns a list of items representing days of the week
Except for the special case formatting, this object is a list of 7 items which represent each day.
Each day can can have one-four time ranges. For example, two time ranges denotes a "lunch-break". No time ranges denotes closed.
Examples:
9am-5pm [["09:00:00", "17:00:00"]]
9am-12pm and 1pm-5pm [["09:00:00", "12:00:00"], ["13:00:00", "17:00:00"]]
Closed - an empty list []
Args:
location_id: DevHub Location ID
hours_type: Defaults to 'primary' unless the user specifies a different typeInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| location_id | Yes | ||
| hours_type | No | primary |
Implementation Reference
- src/devhub_cms_mcp/server.py:24-47 (handler)The main handler function for the 'get_hours_of_operation' tool, decorated with @mcp.tool() for registration. The docstring defines the input schema and output format. It fetches location data from DevHub API using get_client() helper and extracts hours.
@mcp.tool() def get_hours_of_operation(location_id: int, hours_type: str = 'primary') -> list: """Get the hours of operation for a DevHub location Returns a list of items representing days of the week Except for the special case formatting, this object is a list of 7 items which represent each day. Each day can can have one-four time ranges. For example, two time ranges denotes a "lunch-break". No time ranges denotes closed. Examples: 9am-5pm [["09:00:00", "17:00:00"]] 9am-12pm and 1pm-5pm [["09:00:00", "12:00:00"], ["13:00:00", "17:00:00"]] Closed - an empty list [] Args: location_id: DevHub Location ID hours_type: Defaults to 'primary' unless the user specifies a different type """ client, base_url = get_client() r = client.get('{}locations/{}'.format(base_url, location_id)) content = json.loads(r.content) return content['hours_by_type'].get(hours_type, []) - src/devhub_cms_mcp/server.py:15-21 (helper)Helper function to initialize the OAuth1 client and base URL for DevHub API calls, used by get_hours_of_operation.
def get_client(): """Get DevHub API client and base_url.""" client = OAuth1Session( os.environ['DEVHUB_API_KEY'], client_secret=os.environ['DEVHUB_API_SECRET']) base_url = '{}/api/v2/'.format(os.environ['DEVHUB_BASE_URL']) return client, base_url - src/devhub_cms_mcp/server.py:24-24 (registration)The @mcp.tool() decorator registers the get_hours_of_operation function as an MCP tool.
@mcp.tool()