FiscalNote People API — Legislators

naftiko: 1.0.0-alpha2
info:
  label: FiscalNote People API — Legislators
  description: 'FiscalNote People API — Legislators. 3 operations. Lead operation: FiscalNote List legislators. Self-contained
    Naftiko capability covering one Fiscalnote business surface.'
  tags:
  - Fiscalnote
  - Legislators
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    FISCALNOTE_API_KEY: FISCALNOTE_API_KEY
capability:
  consumes:
  - type: http
    namespace: people-legislators
    baseUri: https://api.fiscalnote.com
    description: FiscalNote People API — Legislators business capability. Self-contained, no shared references.
    resources:
    - name: people-v2-legislators
      path: /people/v2/legislators
      operations:
      - name: listlegislators
        method: GET
        description: FiscalNote List legislators
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: district
          in: query
          type: string
          description: Filter by district number or identifier.
        - name: active
          in: query
          type: boolean
          description: Filter by active status. Set to true for currently serving legislators.
    - name: people-v2-legislators-legislatorId
      path: /people/v2/legislators/{legislatorId}
      operations:
      - name: getlegislator
        method: GET
        description: FiscalNote Get legislator by ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: legislatorId
          in: path
          type: string
          description: The unique identifier of the legislator.
          required: true
    - name: people-v2-legislators-legislatorId-votes
      path: /people/v2/legislators/{legislatorId}/votes
      operations:
      - name: listlegislatorvotes
        method: GET
        description: FiscalNote List legislator votes
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: legislatorId
          in: path
          type: string
          description: The unique identifier of the legislator.
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.FISCALNOTE_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: people-legislators-rest
    port: 8080
    description: REST adapter for FiscalNote People API — Legislators. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/people/v2/legislators
      name: people-v2-legislators
      description: REST surface for people-v2-legislators.
      operations:
      - method: GET
        name: listlegislators
        description: FiscalNote List legislators
        call: people-legislators.listlegislators
        with:
          district: rest.district
          active: rest.active
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/people/v2/legislators/{legislatorid}
      name: people-v2-legislators-legislatorid
      description: REST surface for people-v2-legislators-legislatorId.
      operations:
      - method: GET
        name: getlegislator
        description: FiscalNote Get legislator by ID
        call: people-legislators.getlegislator
        with:
          legislatorId: rest.legislatorId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/people/v2/legislators/{legislatorid}/votes
      name: people-v2-legislators-legislatorid-votes
      description: REST surface for people-v2-legislators-legislatorId-votes.
      operations:
      - method: GET
        name: listlegislatorvotes
        description: FiscalNote List legislator votes
        call: people-legislators.listlegislatorvotes
        with:
          legislatorId: rest.legislatorId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: people-legislators-mcp
    port: 9090
    transport: http
    description: MCP adapter for FiscalNote People API — Legislators. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: fiscalnote-list-legislators
      description: FiscalNote List legislators
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-legislators.listlegislators
      with:
        district: tools.district
        active: tools.active
      outputParameters:
      - type: object
        mapping: $.
    - name: fiscalnote-get-legislator-id
      description: FiscalNote Get legislator by ID
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-legislators.getlegislator
      with:
        legislatorId: tools.legislatorId
      outputParameters:
      - type: object
        mapping: $.
    - name: fiscalnote-list-legislator-votes
      description: FiscalNote List legislator votes
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: people-legislators.listlegislatorvotes
      with:
        legislatorId: tools.legislatorId
      outputParameters:
      - type: object
        mapping: $.