naftiko: 1.0.0-alpha2
info:
  label: Paragon ActionKit — Tools
  description: ActionKit Tools API. List and execute Paragon's catalog of pre-built Integration Tools across 130+ SaaS apps for AI agents and apps. Companion to the Paragon MCP server.
  tags:
    - Paragon
    - ActionKit
    - AI Agents
    - MCP
  created: '2026-05-22'
  modified: '2026-05-22'
binds:
  - namespace: env
    keys:
      PARAGON_USER_TOKEN: PARAGON_USER_TOKEN
      PARAGON_PROJECT_ID: PARAGON_PROJECT_ID
capability:
  consumes:
    - type: http
      namespace: actionkit-tools
      baseUri: https://actionkit.useparagon.com
      description: Paragon ActionKit Tools API consumer.
      resources:
        - name: projects-projectId-actions
          path: /projects/{projectId}/actions
          operations:
            - name: listActions
              method: GET
              description: Paragon List Available Actions
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: projectId
                  in: path
                  type: string
                  required: true
                - name: integration
                  in: query
                  type: string
                  required: false
                - name: format
                  in: query
                  type: string
                  required: false
        - name: projects-projectId-actions-action
          path: /projects/{projectId}/actions/{action}
          operations:
            - name: runAction
              method: POST
              description: Paragon Run Action
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: projectId
                  in: path
                  type: string
                  required: true
                - name: action
                  in: path
                  type: string
                  required: true
                - name: body
                  in: body
                  type: object
                  required: true
      authentication:
        type: bearer
        token: '{{env.PARAGON_USER_TOKEN}}'
  exposes:
    - type: mcp
      namespace: actionkit-tools-mcp
      port: 9090
      transport: http
      description: MCP adapter for ActionKit Tools. One tool per consumed operation.
      tools:
        - name: paragon-actionkit-list-actions
          description: List ActionKit Integration Tools available to a Connected User.
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: actionkit-tools.listActions
          with:
            projectId: tools.projectId
            integration: tools.integration
            format: tools.format
          outputParameters:
            - type: object
              mapping: $.
        - name: paragon-actionkit-run-action
          description: Execute an ActionKit Integration Tool on behalf of a Connected User.
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: actionkit-tools.runAction
          with:
            projectId: tools.projectId
            action: tools.action
            body: tools.body
          outputParameters:
            - type: object
              mapping: $.