DevHub CMS MCP

Instructions

Returns a list of locations with the following fields:
- id: Location ID that can be used in the other tools
- location_name: Location name
- location_url: Location URL in DevHub
- street: Street address
- city: City
- state: State
- country: Country
- postal_code: Postal code
- lat: Latitude
- lon: Longitude

Implementation Reference

• src/devhub_cms_mcp/server.py:71-106 (handler)

  The primary handler for the 'get_locations' MCP tool. It is registered via the @mcp.tool() decorator in FastMCP. The function retrieves locations for a given business_id from the DevHub API, formats them into a list of dicts with specified fields, and returns it. The docstring provides the input/output schema details.

  @mcp.tool()
  def get_locations(business_id: int) -> list:
      """Get all locations for a business
  
      Returns a list of locations with the following fields:
      - id: Location ID that can be used in the other tools
      - location_name: Location name
      - location_url: Location URL in DevHub
      - street: Street address
      - city: City
      - state: State
      - country: Country
      - postal_code: Postal code
      - lat: Latitude
      - lon: Longitude
      """
      client, base_url = get_client()
      params = {
          'business_id': business_id,
          'limit': 600,
          'order_by': 'location_name',
      }
      r = client.get('{}locations/'.format(base_url), params=params)
      content = json.loads(r.content)
      return [{
          'id': location['id'],
          'location_name': location['location_name'],
          'location_url': location['location_url'],
          'street': location['street'],
          'city': location['city'],
          'state': location['state'],
          'country': location['country'],
          'postal_code': location['postal_code'],
          'lat': location['lat'],
          'lon': location['lon'],
      } for location in content['objects']]