CFPB HMDA Data Browser API — Filers

naftiko: 1.0.0-alpha2
info:
  label: CFPB HMDA Data Browser API — Filers
  description: 'CFPB HMDA Data Browser API — Filers. 1 operations. Lead operation: List HMDA filers. Self-contained Naftiko
    capability covering one Consumer Financial Protection Bureau business surface.'
  tags:
  - Consumer Financial Protection Bureau
  - Filers
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CONSUMER_FINANCIAL_PROTECTION_BUREAU_API_KEY: CONSUMER_FINANCIAL_PROTECTION_BUREAU_API_KEY
capability:
  consumes:
  - type: http
    namespace: cfpb-hmda-data-browser-filers
    baseUri: https://ffiec.cfpb.gov/v2/data-browser-api
    description: CFPB HMDA Data Browser API — Filers business capability. Self-contained, no shared references.
    resources:
    - name: view-filers
      path: /view/filers
      operations:
      - name: listfilers
        method: GET
        description: List HMDA filers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: states
          in: query
          type: array
  exposes:
  - type: rest
    namespace: cfpb-hmda-data-browser-filers-rest
    port: 8080
    description: REST adapter for CFPB HMDA Data Browser API — Filers. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/view/filers
      name: view-filers
      description: REST surface for view-filers.
      operations:
      - method: GET
        name: listfilers
        description: List HMDA filers
        call: cfpb-hmda-data-browser-filers.listfilers
        with:
          states: rest.states
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cfpb-hmda-data-browser-filers-mcp
    port: 9090
    transport: http
    description: MCP adapter for CFPB HMDA Data Browser API — Filers. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-hmda-filers
      description: List HMDA filers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cfpb-hmda-data-browser-filers.listfilers
      with:
        states: tools.states
      outputParameters:
      - type: object
        mapping: $.