ACI.dev API — Functions

naftiko: 1.0.0-alpha2
info:
  label: ACI.dev API — Functions
  description: ACI.dev Functions surface. Search, inspect, and execute the callable tool operations exposed by configured Apps. Powers the unified MCP server's ACI_SEARCH_FUNCTIONS and ACI_EXECUTE_FUNCTION meta-tools.
  tags:
  - ACI.dev
  - Functions
  - Tool Calling
  - MCP
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    ACI_API_KEY: ACI_API_KEY
    LINKED_ACCOUNT_OWNER_ID: LINKED_ACCOUNT_OWNER_ID
capability:
  consumes:
  - type: http
    namespace: functions
    baseUri: https://api.aci.dev
    description: ACI.dev Functions consumed surface.
    resources:
    - name: v1-functions-search
      path: /v1/functions/search
      operations:
      - name: searchfunctions
        method: GET
        description: Search Functions by natural-language intent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: array
          value: $.
        inputParameters:
        - name: intent
          in: query
          type: string
        - name: app_names
          in: query
          type: array
        - name: allowed_apps_only
          in: query
          type: boolean
        - name: format
          in: query
          type: string
          description: Output format (basic, openai, anthropic).
        - name: limit
          in: query
          type: integer
        - name: offset
          in: query
          type: integer
    - name: v1-function-definition
      path: /v1/functions/{function_name}/definition
      operations:
      - name: getfunctiondefinition
        method: GET
        description: Get Function Definition for a function name.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: function_name
          in: path
          type: string
          required: true
        - name: format
          in: query
          type: string
    - name: v1-function-execute
      path: /v1/functions/{function_name}/execute
      operations:
      - name: executefunction
        method: POST
        description: Execute a Function on behalf of a linked account.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: function_name
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: FunctionExecute payload including function_input and linked_account_owner_id.
          required: true
    authentication:
      type: apikey
      key: X-API-KEY
      value: '{{env.ACI_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: functions-mcp
    port: 9091
    transport: http
    description: MCP adapter for ACI.dev Functions. Mirrors the unified MCP server meta-tools.
    tools:
    - name: aci-search-functions
      description: ACI_SEARCH_FUNCTIONS — search for tools available across configured Apps.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: functions.searchfunctions
      with:
        intent: tools.intent
        app_names: tools.app_names
        allowed_apps_only: tools.allowed_apps_only
        format: tools.format
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: array
        mapping: $.
    - name: aci-get-function-definition
      description: Retrieve the OpenAI- or Anthropic-compatible function definition for a tool.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: functions.getfunctiondefinition
      with:
        function_name: tools.function_name
        format: tools.format
      outputParameters:
      - type: object
        mapping: $.
    - name: aci-execute-function
      description: ACI_EXECUTE_FUNCTION — execute a tool on behalf of a linked account.
      hints:
        readOnly: false
        destructive: true
        idempotent: false
      call: functions.executefunction
      with:
        function_name: tools.function_name
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.