naftiko: 1.0.0-alpha2
info:
  label: SSA Field Office Address API
  description: The Social Security Administration Field Office Address API provides location data, addresses, telephone numbers,
    and office hours for SSA Field Offices across the United States. The data is served through the Esri ArcGIS Online platform
    as a RESTful Feature Service. No authentication required — all data is publicly available.
  tags:
  - Social
  - Security
  - Administration
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: social-security-administration
    baseUri: https://services6.arcgis.com/zFiipv75rloRP5N4/ArcGIS/rest/services/Office_Points/FeatureServer
    description: SSA Field Office Address API HTTP API.
    resources:
    - name: 1-query
      path: /1/query
      operations:
      - name: queryfieldoffices
        method: GET
        description: Query Field Offices
        inputParameters:
        - name: where
          in: query
          type: string
          required: true
          description: SQL WHERE clause to filter records (use '1=1' for all records)
        - name: outFields
          in: query
          type: string
          description: Comma-separated list of fields to return, or * for all fields
        - name: f
          in: query
          type: string
          description: Response format
        - name: resultOffset
          in: query
          type: integer
          description: Offset for pagination
        - name: resultRecordCount
          in: query
          type: integer
          description: Maximum number of records to return
        - name: orderByFields
          in: query
          type: string
          description: Fields to sort results by
        - name: geometry
          in: query
          type: string
          description: Spatial filter geometry (JSON)
        - name: geometryType
          in: query
          type: string
          description: Type of spatial geometry filter
        - name: inSR
          in: query
          type: integer
          description: Spatial reference of input geometry
        - name: spatialRel
          in: query
          type: string
          description: Spatial relationship for filtering
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: social-security-administration-rest
    description: REST adapter for SSA Field Office Address API.
    resources:
    - path: /1/query
      name: queryfieldoffices
      operations:
      - method: GET
        name: queryfieldoffices
        description: Query Field Offices
        call: social-security-administration.queryfieldoffices
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: social-security-administration-mcp
    transport: http
    description: MCP adapter for SSA Field Office Address API for AI agent use.
    tools:
    - name: queryfieldoffices
      description: Query Field Offices
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: social-security-administration.queryfieldoffices
      with:
        where: tools.where
        outFields: tools.outFields
        f: tools.f
        resultOffset: tools.resultOffset
        resultRecordCount: tools.resultRecordCount
        orderByFields: tools.orderByFields
        geometry: tools.geometry
        geometryType: tools.geometryType
        inSR: tools.inSR
        spatialRel: tools.spatialRel
      inputParameters:
      - name: where
        type: string
        description: SQL WHERE clause to filter records (use '1=1' for all records)
        required: true
      - name: outFields
        type: string
        description: Comma-separated list of fields to return, or * for all fields
      - name: f
        type: string
        description: Response format
      - name: resultOffset
        type: integer
        description: Offset for pagination
      - name: resultRecordCount
        type: integer
        description: Maximum number of records to return
      - name: orderByFields
        type: string
        description: Fields to sort results by
      - name: geometry
        type: string
        description: Spatial filter geometry (JSON)
      - name: geometryType
        type: string
        description: Type of spatial geometry filter
      - name: inSR
        type: integer
        description: Spatial reference of input geometry
      - name: spatialRel
        type: string
        description: Spatial relationship for filtering
      outputParameters:
      - type: object
        mapping: $.