Wufoo REST API — Forms

naftiko: "1.0.0-alpha2"

info:
  label: "Wufoo REST API — Forms"
  description: >-
    Forms surface of the Wufoo REST API v3. 3 operations. Lead operation: List All
    Forms. Self-contained Naftiko capability covering one Wufoo business surface.
  tags:
    - Wufoo
    - Forms
    - FormBuilder
  created: "2026-05-23"
  modified: "2026-05-23"

binds:
  - namespace: env
    keys:
      WUFOO_SUBDOMAIN: WUFOO_SUBDOMAIN
      WUFOO_API_KEY: WUFOO_API_KEY

capability:

  consumes:
    - type: http
      namespace: "rest-v3-forms"
      baseUri: "https://{{env.WUFOO_SUBDOMAIN}}.wufoo.com/api/v3"
      description: "Wufoo REST API — Forms business capability. Self-contained, no shared references."
      authentication:
        type: basic
        username: "{{env.WUFOO_API_KEY}}"
        password: "footastic"
      resources:
        - name: "forms"
          path: "/forms.{format}"
          operations:
            - name: "listForms"
              method: GET
              description: "List all forms accessible to the API key."
              inputParameters:
                - { name: format, in: path, type: string, required: true, description: "json or xml" }
                - { name: page, in: query, type: integer, required: false, description: "Page number, default 1." }
                - { name: limit, in: query, type: integer, required: false, description: "Page size, max 1000." }
                - { name: includeTodayCount, in: query, type: boolean, required: false, description: "Include today's entry count." }
                - { name: pretty, in: query, type: boolean, required: false, description: "Pretty-print response." }
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: "$." }]
        - name: "form"
          path: "/forms/{identifier}.{format}"
          operations:
            - name: "getForm"
              method: GET
              description: "Return a single form by hash or title."
              inputParameters:
                - { name: identifier, in: path, type: string, required: true, description: "Form hash or title." }
                - { name: format, in: path, type: string, required: true, description: "json or xml" }
                - { name: includeTodayCount, in: query, type: boolean, required: false, description: "Include today's entry count." }
                - { name: pretty, in: query, type: boolean, required: false, description: "Pretty-print response." }
              outputRawFormat: json
              outputParameters: [{ name: result, type: object, value: "$." }]

  exposes:
    - type: rest
      namespace: "rest-v3-forms-rest"
      port: 8080
      description: "REST adapter for Wufoo REST API — Forms."
      resources:
        - path: "/v1/forms"
          name: "forms"
          description: "Wufoo forms collection."
          operations:
            - method: GET
              name: "listForms"
              description: "List all forms accessible to the API key."
              call: "rest-v3-forms.listForms"
              with:
                format: "rest.format"
                page: "rest.page"
                limit: "rest.limit"
                includeTodayCount: "rest.includeTodayCount"
                pretty: "rest.pretty"
              outputParameters: [{ type: object, mapping: "$." }]
        - path: "/v1/forms/{identifier}"
          name: "form"
          description: "A single Wufoo form by hash or title."
          operations:
            - method: GET
              name: "getForm"
              description: "Return a single form."
              call: "rest-v3-forms.getForm"
              with:
                identifier: "rest.identifier"
                format: "rest.format"
                includeTodayCount: "rest.includeTodayCount"
                pretty: "rest.pretty"
              outputParameters: [{ type: object, mapping: "$." }]

    - type: mcp
      namespace: "rest-v3-forms-mcp"
      port: 9090
      transport: http
      description: "MCP adapter for Wufoo REST API — Forms."
      tools:
        - name: "list-forms"
          description: "List all forms accessible to the API key."
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: "rest-v3-forms.listForms"
          with:
            format: "tools.format"
            page: "tools.page"
            limit: "tools.limit"
            includeTodayCount: "tools.includeTodayCount"
            pretty: "tools.pretty"
          outputParameters: [{ type: object, mapping: "$." }]
        - name: "get-form"
          description: "Return a single form by hash or title."
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: "rest-v3-forms.getForm"
          with:
            identifier: "tools.identifier"
            format: "tools.format"
            includeTodayCount: "tools.includeTodayCount"
            pretty: "tools.pretty"
          outputParameters: [{ type: object, mapping: "$." }]