Walk Score Location Intelligence

naftiko: "1.0.0-alpha1"

info:
  label: "Walk Score Location Intelligence"
  description: >-
    Workflow capability combining Walk Score and Transit APIs for comprehensive
    location intelligence. Enables applications to assess any location's walkability,
    transit accessibility, and bikeability in a unified workflow. Used by real estate
    platforms, city planners, commute calculators, and property search applications
    to provide complete transportation accessibility scoring.
  tags:
    - Walk Score
    - Location Intelligence
    - Walkability
    - Transit
    - Bikeability
    - Real Estate
    - Urban Planning
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      WALKSCORE_API_KEY: WALKSCORE_API_KEY

capability:
  consumes:
    - import: walk-score-api
      location: ./shared/walk-score.yaml
    - import: walk-score-transit
      location: ./shared/walk-score-transit.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: walk-score-location-intelligence-api
      description: "Unified REST API for Walk Score location intelligence and transit data."
      resources:
        - path: /v1/scores
          name: scores
          description: "Get Walk Score, Transit Score, and Bike Score for a location"
          operations:
            - method: GET
              name: get-walk-score
              description: "Get all walkability scores for a location"
              call: "walk-score-api.get-walk-score"
              with:
                lat: "rest.lat"
                lon: "rest.lon"
                address: "rest.address"
                transit: "rest.transit"
                bike: "rest.bike"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/transit-scores
          name: transit-scores
          description: "Get detailed Transit Score for a city location"
          operations:
            - method: GET
              name: get-transit-score
              description: "Get Transit Score with route summary for a city location"
              call: "walk-score-transit.get-transit-score"
              with:
                lat: "rest.lat"
                lon: "rest.lon"
                city: "rest.city"
                state: "rest.state"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/transit-stops
          name: transit-stops
          description: "Find nearby transit stops"
          operations:
            - method: GET
              name: search-transit-stops
              description: "Get transit stops near a location"
              call: "walk-score-transit.search-transit-stops"
              with:
                lat: "rest.lat"
                lon: "rest.lon"
              outputParameters:
                - type: array
                  mapping: "$."
        - path: /v1/transit-network
          name: transit-network
          description: "Get transit network within one mile"
          operations:
            - method: GET
              name: search-transit-network
              description: "Get all routes and stops within one mile"
              call: "walk-score-transit.search-transit-network"
              with:
                lat: "rest.lat"
                lon: "rest.lon"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/transit-stops/{stopId}
          name: transit-stop-detail
          description: "Get a specific transit stop"
          operations:
            - method: GET
              name: get-transit-stop
              description: "Get transit stop details"
              call: "walk-score-transit.get-transit-stop"
              with:
                stopId: "rest.stopId"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/transit-routes/{routeId}
          name: transit-route-detail
          description: "Get a specific transit route"
          operations:
            - method: GET
              name: get-transit-route
              description: "Get transit route details and geometry"
              call: "walk-score-transit.get-transit-route"
              with:
                routeId: "rest.routeId"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/cities
          name: supported-cities
          description: "List cities with transit score support"
          operations:
            - method: GET
              name: list-supported-cities
              description: "Get all cities supported by Transit API"
              call: "walk-score-transit.list-supported-cities"
              outputParameters:
                - type: array
                  mapping: "$."

    - type: mcp
      port: 9080
      namespace: walk-score-location-intelligence-mcp
      transport: http
      description: "MCP server for AI-assisted Walk Score location intelligence workflows."
      tools:
        - name: get-location-scores
          description: >-
            Get Walk Score, Transit Score, and Bike Score for any address or coordinates.
            Returns walkability, transit accessibility, and bikeability in one call.
          hints:
            readOnly: true
            openWorld: true
          call: "walk-score-api.get-walk-score"
          with:
            lat: "tools.lat"
            lon: "tools.lon"
            address: "tools.address"
            transit: "tools.transit"
            bike: "tools.bike"
            format: "json"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-transit-score
          description: "Get detailed Transit Score with route count summary for a city location"
          hints:
            readOnly: true
            openWorld: true
          call: "walk-score-transit.get-transit-score"
          with:
            lat: "tools.lat"
            lon: "tools.lon"
            city: "tools.city"
            state: "tools.state"
          outputParameters:
            - type: object
              mapping: "$."
        - name: find-nearby-transit-stops
          description: "Find public transit stops near any location with route details"
          hints:
            readOnly: true
            openWorld: true
          call: "walk-score-transit.search-transit-stops"
          with:
            lat: "tools.lat"
            lon: "tools.lon"
          outputParameters:
            - type: array
              mapping: "$."
        - name: get-transit-network
          description: "Get all transit routes and stops within one mile of a location"
          hints:
            readOnly: true
            openWorld: true
          call: "walk-score-transit.search-transit-network"
          with:
            lat: "tools.lat"
            lon: "tools.lon"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-transit-stop-details
          description: "Get details for a specific transit stop by ID"
          hints:
            readOnly: true
            openWorld: false
          call: "walk-score-transit.get-transit-stop"
          with:
            stopId: "tools.stopId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-transit-route-details
          description: "Get details for a transit route including stops and route geometry"
          hints:
            readOnly: true
            openWorld: false
          call: "walk-score-transit.get-transit-route"
          with:
            routeId: "tools.routeId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-transit-cities
          description: "Get the list of all cities supported by the Walk Score Transit API"
          hints:
            readOnly: true
            openWorld: false
          call: "walk-score-transit.list-supported-cities"
          outputParameters:
            - type: array
              mapping: "$."