naftiko: 1.0.0-alpha2
info:
  label: SignNow Document Signing
  description: Workflow capability for end-to-end electronic document signing using SignNow. Covers document preparation,
    template-based workflows, signature invitation, bulk signing, and envelope management for legal and business agreement
    workflows.
  tags:
  - E-Signature
  - Document Signing
  - Contract Management
  - Workflow Automation
  - Legal
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    SIGNNOW_ACCESS_TOKEN: SIGNNOW_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: signnow
    baseUri: https://api.signnow.com
    description: SignNow REST API for e-signature workflows and document management.
    authentication:
      type: bearer
      token: '{{SIGNNOW_ACCESS_TOKEN}}'
    resources:
    - name: documents
      path: /document
      description: Document upload and management operations.
      operations:
      - name: list-documents
        method: GET
        description: List all documents for the authenticated user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
      - name: upload-document
        method: POST
        description: Upload a PDF document for e-signature processing.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: document
      path: /document/{document_id}
      description: Single document operations.
      operations:
      - name: get-document
        method: GET
        description: Retrieve document details including fields, signers, and status.
        inputParameters:
        - name: document_id
          in: path
          type: string
          required: true
          description: Unique document identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete-document
        method: DELETE
        description: Permanently delete a document.
        inputParameters:
        - name: document_id
          in: path
          type: string
          required: true
          description: Unique document identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: document-download
      path: /document/{document_id}/download
      description: Document download operations.
      operations:
      - name: download-document
        method: GET
        description: Download a signed document as PDF.
        inputParameters:
        - name: document_id
          in: path
          type: string
          required: true
          description: Unique document identifier.
        - name: type
          in: query
          type: string
          required: false
          description: 'Download type: collapsed or with_history.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: signature-invite
      path: /document/{document_id}/invite
      description: Signature invitation operations.
      operations:
      - name: send-signature-invite
        method: POST
        description: Send a signature invitation to one or more recipients.
        inputParameters:
        - name: document_id
          in: path
          type: string
          required: true
          description: Unique document identifier.
        body:
          type: json
          data:
            from: '{{tools.from_email}}'
            to: '{{tools.recipients}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: cancel-invite
      path: /document/{document_id}/fieldinvitecancel
      description: Cancel signature invite operations.
      operations:
      - name: cancel-signature-invite
        method: PUT
        description: Cancel all pending signature invitations for a document.
        inputParameters:
        - name: document_id
          in: path
          type: string
          required: true
          description: Unique document identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: templates
      path: /template
      description: Template management operations.
      operations:
      - name: list-templates
        method: GET
        description: List all document templates.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
      - name: create-template
        method: POST
        description: Create a new reusable document template.
        body:
          type: json
          data:
            document_id: '{{tools.document_id}}'
            document_name: '{{tools.document_name}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: template
      path: /template/{template_id}
      description: Single template operations.
      operations:
      - name: get-template
        method: GET
        description: Retrieve details of a specific document template.
        inputParameters:
        - name: template_id
          in: path
          type: string
          required: true
          description: Unique template identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete-template
        method: DELETE
        description: Delete a document template.
        inputParameters:
        - name: template_id
          in: path
          type: string
          required: true
          description: Unique template identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: bulk-invite
      path: /template/{template_id}/bulkinvite
      description: Bulk invitation operations.
      operations:
      - name: send-bulk-invite
        method: POST
        description: Send signature invitations to multiple recipients using CSV.
        inputParameters:
        - name: template_id
          in: path
          type: string
          required: true
          description: Unique template identifier.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users
      path: /user
      description: User management operations.
      operations:
      - name: create-user
        method: POST
        description: Create a new SignNow user account.
        body:
          type: json
          data:
            email: '{{tools.email}}'
            password: '{{tools.password}}'
            first_name: '{{tools.first_name}}'
            last_name: '{{tools.last_name}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: current-user
      path: /user/me
      description: Current user profile operations.
      operations:
      - name: get-current-user
        method: GET
        description: Retrieve the profile of the authenticated user.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: webhooks
      path: /api/events
      description: Webhook subscription management.
      operations:
      - name: list-webhooks
        method: GET
        description: List all registered webhook subscriptions.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
      - name: create-webhook
        method: POST
        description: Register a new webhook event subscription.
        body:
          type: json
          data:
            event: '{{tools.event}}'
            action: '{{tools.callback_url}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: envelopes
      path: /documentgroup
      description: Document group envelope operations.
      operations:
      - name: list-envelopes
        method: GET
        description: List all document group envelopes.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
      - name: create-envelope
        method: POST
        description: Create a new document group envelope.
        body:
          type: json
          data:
            document_ids: '{{tools.document_ids}}'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: document-signing-api
    description: Unified REST API for end-to-end electronic document signing workflows.
    resources:
    - path: /v1/documents
      name: documents
      description: Document lifecycle management.
      operations:
      - method: GET
        name: list-documents
        description: List all documents with their signing status.
        call: signnow.list-documents
        outputParameters:
        - type: array
          mapping: $.
      - method: POST
        name: upload-document
        description: Upload a PDF document to begin the signing workflow.
        call: signnow.upload-document
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/documents/{id}
      name: document
      description: Single document operations.
      operations:
      - method: GET
        name: get-document
        description: Retrieve document details, fields, and current signing status.
        call: signnow.get-document
        with:
          document_id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete-document
        description: Delete a document from the system.
        call: signnow.delete-document
        with:
          document_id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/documents/{id}/download
      name: document-download
      description: Document download.
      operations:
      - method: GET
        name: download-document
        description: Download a document as a signed PDF.
        call: signnow.download-document
        with:
          document_id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/documents/{id}/invite
      name: signature-invite
      description: Signature invitation management.
      operations:
      - method: POST
        name: send-signature-invite
        description: Send signature invitations to one or more recipients.
        call: signnow.send-signature-invite
        with:
          document_id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/documents/{id}/cancel-invite
      name: cancel-invite
      description: Cancel pending signature invites.
      operations:
      - method: POST
        name: cancel-signature-invite
        description: Cancel all pending signature invitations for a document.
        call: signnow.cancel-signature-invite
        with:
          document_id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/templates
      name: templates
      description: Document template management.
      operations:
      - method: GET
        name: list-templates
        description: List all reusable document templates.
        call: signnow.list-templates
        outputParameters:
        - type: array
          mapping: $.
      - method: POST
        name: create-template
        description: Create a reusable template from an existing document.
        call: signnow.create-template
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/templates/{id}
      name: template
      description: Single template operations.
      operations:
      - method: GET
        name: get-template
        description: Retrieve a specific template with its fields and roles.
        call: signnow.get-template
        with:
          template_id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete-template
        description: Delete a document template.
        call: signnow.delete-template
        with:
          template_id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/templates/{id}/bulk-invite
      name: bulk-invite
      description: Bulk signature invitation.
      operations:
      - method: POST
        name: send-bulk-invite
        description: Send signature invitations to multiple recipients via CSV.
        call: signnow.send-bulk-invite
        with:
          template_id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/envelopes
      name: envelopes
      description: Document group envelope management.
      operations:
      - method: GET
        name: list-envelopes
        description: List all document group envelopes.
        call: signnow.list-envelopes
        outputParameters:
        - type: array
          mapping: $.
      - method: POST
        name: create-envelope
        description: Create a document group envelope for coordinated multi-document signing.
        call: signnow.create-envelope
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/webhooks
      name: webhooks
      description: Webhook event subscription management.
      operations:
      - method: GET
        name: list-webhooks
        description: List all active webhook subscriptions.
        call: signnow.list-webhooks
        outputParameters:
        - type: array
          mapping: $.
      - method: POST
        name: create-webhook
        description: Register a webhook to receive signing event notifications.
        call: signnow.create-webhook
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/users/me
      name: current-user
      description: Current user profile.
      operations:
      - method: GET
        name: get-current-user
        description: Retrieve the current user's profile and subscription information.
        call: signnow.get-current-user
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: document-signing-mcp
    transport: http
    description: MCP server for AI-assisted electronic document signing and workflow management.
    tools:
    - name: list-documents
      description: List all e-signature documents and their current signing status.
      hints:
        readOnly: true
        openWorld: true
      call: signnow.list-documents
      outputParameters:
      - type: array
        mapping: $.
    - name: upload-document
      description: Upload a PDF document to begin an e-signature workflow.
      hints:
        readOnly: false
      call: signnow.upload-document
      outputParameters:
      - type: object
        mapping: $.
    - name: get-document
      description: Retrieve full details of a specific document including its fields and signing status.
      hints:
        readOnly: true
      call: signnow.get-document
      with:
        document_id: tools.document_id
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-document
      description: Permanently delete a document from SignNow.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: signnow.delete-document
      with:
        document_id: tools.document_id
      outputParameters:
      - type: object
        mapping: $.
    - name: download-document
      description: Download a completed signed document as a PDF.
      hints:
        readOnly: true
      call: signnow.download-document
      with:
        document_id: tools.document_id
      outputParameters:
      - type: object
        mapping: $.
    - name: send-signature-invite
      description: Send e-signature invitations to one or more recipients for a document.
      hints:
        readOnly: false
      call: signnow.send-signature-invite
      with:
        document_id: tools.document_id
      outputParameters:
      - type: object
        mapping: $.
    - name: cancel-signature-invite
      description: Cancel all pending signature invitations for a document.
      hints:
        readOnly: false
        destructive: false
      call: signnow.cancel-signature-invite
      with:
        document_id: tools.document_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-templates
      description: List all available document templates for e-signature workflows.
      hints:
        readOnly: true
        openWorld: true
      call: signnow.list-templates
      outputParameters:
      - type: array
        mapping: $.
    - name: get-template
      description: Retrieve a specific document template with its signing fields and roles.
      hints:
        readOnly: true
      call: signnow.get-template
      with:
        template_id: tools.template_id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-template
      description: Create a reusable e-signature template from an existing document.
      hints:
        readOnly: false
      call: signnow.create-template
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-template
      description: Delete a document template from SignNow.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: signnow.delete-template
      with:
        template_id: tools.template_id
      outputParameters:
      - type: object
        mapping: $.
    - name: send-bulk-invite
      description: Send e-signature invitations to multiple recipients using a CSV file and template.
      hints:
        readOnly: false
      call: signnow.send-bulk-invite
      with:
        template_id: tools.template_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-envelopes
      description: List all document group envelopes for coordinated multi-document signing.
      hints:
        readOnly: true
        openWorld: true
      call: signnow.list-envelopes
      outputParameters:
      - type: array
        mapping: $.
    - name: create-envelope
      description: Create a document group envelope to coordinate signing across multiple documents.
      hints:
        readOnly: false
      call: signnow.create-envelope
      outputParameters:
      - type: object
        mapping: $.
    - name: get-envelope
      description: Retrieve details of a specific document group envelope.
      hints:
        readOnly: true
      call: signnow.get-envelope
      with:
        group_id: tools.group_id
      outputParameters:
      - type: object
        mapping: $.
    - name: list-webhooks
      description: List all active webhook event subscriptions.
      hints:
        readOnly: true
      call: signnow.list-webhooks
      outputParameters:
      - type: array
        mapping: $.
    - name: create-webhook
      description: Register a webhook to receive notifications when document signing events occur.
      hints:
        readOnly: false
      call: signnow.create-webhook
      outputParameters:
      - type: object
        mapping: $.
    - name: get-current-user
      description: Retrieve current user profile, subscription details, and usage information.
      hints:
        readOnly: true
      call: signnow.get-current-user
      outputParameters:
      - type: object
        mapping: $.