Salesforce — Describe

naftiko: 1.0.0-alpha2
info:
  label: Salesforce — Describe
  description: 'Salesforce — Describe. 13 operations. Lead operation: Salesforce Describe Global. Self-contained Naftiko capability
    covering one Salesforce business surface.'
  tags:
  - Salesforce
  - Describe
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SALESFORCE_API_KEY: SALESFORCE_API_KEY
capability:
  consumes:
  - type: http
    namespace: salesforce-describe
    baseUri: https://login.salesforce.com
    description: Salesforce — Describe business capability. Self-contained, no shared references.
    resources:
    - name: data-v64.0-sobjects
      path: /data/v64.0/sobjects
      operations:
      - name: describeglobal
        method: GET
        description: Salesforce Describe Global
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
          required: true
    - name: data-v64.0-sobjects-EventRelayFeedback-describe
      path: /data/v64.0/sobjects/EventRelayFeedback/describe
      operations:
      - name: describeeventfelayfeedback
        method: GET
        description: Salesforce Describe Event Felay Feedback
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: data-v64.0-sobjects-Global-describe-layouts
      path: /data/v64.0/sobjects/Global/describe/layouts
      operations:
      - name: describegloballayouts
        method: GET
        description: Salesforce Describe Global Layouts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Type
          in: header
          type: string
          required: true
    - name: data-v64.0-sobjects-SOBJECT_API_NAME-describe
      path: /data/v64.0/sobjects/{SOBJECT_API_NAME}/describe
      operations:
      - name: sobjectdescribe
        method: GET
        description: Salesforce Sobject Describe
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: SOBJECT_API_NAME
          in: path
          type: string
          description: Object API name
          required: true
        - name: Content-Type
          in: header
          type: string
          required: true
    - name: data-v64.0-sobjects-SOBJECT_API_NAME-describe-layouts
      path: /data/v64.0/sobjects/{SOBJECT_API_NAME}/describe/layouts
      operations:
      - name: describesobjectlayouts
        method: GET
        description: Salesforce Describe Sobject Layouts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: SOBJECT_API_NAME
          in: path
          type: string
          required: true
        - name: Content-Type
          in: header
          type: string
          required: true
    - name: data-v64.0-sobjects-SOBJECT_API_NAME-describe-layouts-RECORD_TYPE_ID
      path: /data/v64.0/sobjects/{SOBJECT_API_NAME}/describe/layouts/{RECORD_TYPE_ID}
      operations:
      - name: describesobjectlayoutsperrecordtype
        method: GET
        description: Salesforce Describe Sobject Layouts Per Record Type
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: SOBJECT_API_NAME
          in: path
          type: string
          required: true
        - name: RECORD_TYPE_ID
          in: path
          type: string
          required: true
        - name: Content-Type
          in: header
          type: string
          required: true
    - name: data-v64.0-sobjects-SOBJECT_API_NAME-listviews-QUERY_LOCATOR-describe
      path: /data/v64.0/sobjects/{SOBJECT_API_NAME}/listviews/{QUERY_LOCATOR}/describe
      operations:
      - name: listviewdescribe
        method: GET
        description: Salesforce List View Describe
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: SOBJECT_API_NAME
          in: path
          type: string
          required: true
        - name: QUERY_LOCATOR
          in: path
          type: string
          required: true
        - name: Content-Type
          in: header
          type: string
          required: true
    - name: data-v64.0-support-embeddedservice-configuration-EMBEDDED_SERVICE_CONFIG_DEVELOP
      path: /data/v64.0/support/embeddedservice/configuration/{EMBEDDED_SERVICE_CONFIG_DEVELOPERNAME}
      operations:
      - name: embeddedserviceconfigurationdescribe
        method: GET
        description: Salesforce Embedded Service Configuration Describe
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: EMBEDDED_SERVICE_CONFIG_DEVELOPERNAME
          in: path
          type: string
          required: true
        - name: Content-Type
          in: header
          type: string
          required: true
    - name: data-v64.0-tooling-sobjects
      path: /data/v64.0/tooling/sobjects
      operations:
      - name: gettoolingdescribe
        method: GET
        description: Salesforce Get Tooling Describe
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: data-v64.0-tooling-sobjects-EventRelayConfig-describe
      path: /data/v64.0/tooling/sobjects/EventRelayConfig/describe
      operations:
      - name: describeeventrelay
        method: GET
        description: Salesforce Describe Event Relay
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: data-v64.0-tooling-sobjects-ManagedEventSubscription-describe
      path: /data/v64.0/tooling/sobjects/ManagedEventSubscription/describe
      operations:
      - name: describemanagedeventsubscription
        method: GET
        description: Salesforce Describe Managed Event Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: data-v64.0-tooling-sobjects-PlatformEventChannel-describe
      path: /data/v64.0/tooling/sobjects/PlatformEventChannel/describe
      operations:
      - name: describeeventchannel
        method: GET
        description: Salesforce Describe Event Channel
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: data-v64.0-tooling-sobjects-SOBJECT_API_NAME-describe
      path: /data/v64.0/tooling/sobjects/{SOBJECT_API_NAME}/describe
      operations:
      - name: gettoolingdescribesobject
        method: GET
        description: Salesforce Get Tooling Describe Sobject
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: SOBJECT_API_NAME
          in: path
          type: string
          required: true
    authentication:
      type: bearer
      token: '{{env.SALESFORCE_API_KEY}}'
  exposes:
  - type: rest
    namespace: salesforce-describe-rest
    port: 8080
    description: REST adapter for Salesforce — Describe. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/data/v64-0/sobjects
      name: data-v64-0-sobjects
      description: REST surface for data-v64.0-sobjects.
      operations:
      - method: GET
        name: describeglobal
        description: Salesforce Describe Global
        call: salesforce-describe.describeglobal
        with:
          Content-Type: rest.Content-Type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/sobjects/eventrelayfeedback/describe
      name: data-v64-0-sobjects-eventrelayfeedback-describe
      description: REST surface for data-v64.0-sobjects-EventRelayFeedback-describe.
      operations:
      - method: GET
        name: describeeventfelayfeedback
        description: Salesforce Describe Event Felay Feedback
        call: salesforce-describe.describeeventfelayfeedback
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/sobjects/global/describe/layouts
      name: data-v64-0-sobjects-global-describe-layouts
      description: REST surface for data-v64.0-sobjects-Global-describe-layouts.
      operations:
      - method: GET
        name: describegloballayouts
        description: Salesforce Describe Global Layouts
        call: salesforce-describe.describegloballayouts
        with:
          Content-Type: rest.Content-Type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/sobjects/{sobject-api-name}/describe
      name: data-v64-0-sobjects-sobject-api-name-describe
      description: REST surface for data-v64.0-sobjects-SOBJECT_API_NAME-describe.
      operations:
      - method: GET
        name: sobjectdescribe
        description: Salesforce Sobject Describe
        call: salesforce-describe.sobjectdescribe
        with:
          SOBJECT_API_NAME: rest.SOBJECT_API_NAME
          Content-Type: rest.Content-Type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/sobjects/{sobject-api-name}/describe/layouts
      name: data-v64-0-sobjects-sobject-api-name-describe-layouts
      description: REST surface for data-v64.0-sobjects-SOBJECT_API_NAME-describe-layouts.
      operations:
      - method: GET
        name: describesobjectlayouts
        description: Salesforce Describe Sobject Layouts
        call: salesforce-describe.describesobjectlayouts
        with:
          SOBJECT_API_NAME: rest.SOBJECT_API_NAME
          Content-Type: rest.Content-Type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/sobjects/{sobject-api-name}/describe/layouts/{record-type-id}
      name: data-v64-0-sobjects-sobject-api-name-describe-layouts-record-type-id
      description: REST surface for data-v64.0-sobjects-SOBJECT_API_NAME-describe-layouts-RECORD_TYPE_ID.
      operations:
      - method: GET
        name: describesobjectlayoutsperrecordtype
        description: Salesforce Describe Sobject Layouts Per Record Type
        call: salesforce-describe.describesobjectlayoutsperrecordtype
        with:
          SOBJECT_API_NAME: rest.SOBJECT_API_NAME
          RECORD_TYPE_ID: rest.RECORD_TYPE_ID
          Content-Type: rest.Content-Type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/sobjects/{sobject-api-name}/listviews/{query-locator}/describe
      name: data-v64-0-sobjects-sobject-api-name-listviews-query-locator-describe
      description: REST surface for data-v64.0-sobjects-SOBJECT_API_NAME-listviews-QUERY_LOCATOR-describe.
      operations:
      - method: GET
        name: listviewdescribe
        description: Salesforce List View Describe
        call: salesforce-describe.listviewdescribe
        with:
          SOBJECT_API_NAME: rest.SOBJECT_API_NAME
          QUERY_LOCATOR: rest.QUERY_LOCATOR
          Content-Type: rest.Content-Type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/support/embeddedservice/configuration/{embedded-service-config-developername}
      name: data-v64-0-support-embeddedservice-configuration-embedded-service-config-develop
      description: REST surface for data-v64.0-support-embeddedservice-configuration-EMBEDDED_SERVICE_CONFIG_DEVELOP.
      operations:
      - method: GET
        name: embeddedserviceconfigurationdescribe
        description: Salesforce Embedded Service Configuration Describe
        call: salesforce-describe.embeddedserviceconfigurationdescribe
        with:
          EMBEDDED_SERVICE_CONFIG_DEVELOPERNAME: rest.EMBEDDED_SERVICE_CONFIG_DEVELOPERNAME
          Content-Type: rest.Content-Type
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/tooling/sobjects
      name: data-v64-0-tooling-sobjects
      description: REST surface for data-v64.0-tooling-sobjects.
      operations:
      - method: GET
        name: gettoolingdescribe
        description: Salesforce Get Tooling Describe
        call: salesforce-describe.gettoolingdescribe
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/tooling/sobjects/eventrelayconfig/describe
      name: data-v64-0-tooling-sobjects-eventrelayconfig-describe
      description: REST surface for data-v64.0-tooling-sobjects-EventRelayConfig-describe.
      operations:
      - method: GET
        name: describeeventrelay
        description: Salesforce Describe Event Relay
        call: salesforce-describe.describeeventrelay
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/tooling/sobjects/managedeventsubscription/describe
      name: data-v64-0-tooling-sobjects-managedeventsubscription-describe
      description: REST surface for data-v64.0-tooling-sobjects-ManagedEventSubscription-describe.
      operations:
      - method: GET
        name: describemanagedeventsubscription
        description: Salesforce Describe Managed Event Subscription
        call: salesforce-describe.describemanagedeventsubscription
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/tooling/sobjects/platformeventchannel/describe
      name: data-v64-0-tooling-sobjects-platformeventchannel-describe
      description: REST surface for data-v64.0-tooling-sobjects-PlatformEventChannel-describe.
      operations:
      - method: GET
        name: describeeventchannel
        description: Salesforce Describe Event Channel
        call: salesforce-describe.describeeventchannel
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/v64-0/tooling/sobjects/{sobject-api-name}/describe
      name: data-v64-0-tooling-sobjects-sobject-api-name-describe
      description: REST surface for data-v64.0-tooling-sobjects-SOBJECT_API_NAME-describe.
      operations:
      - method: GET
        name: gettoolingdescribesobject
        description: Salesforce Get Tooling Describe Sobject
        call: salesforce-describe.gettoolingdescribesobject
        with:
          SOBJECT_API_NAME: rest.SOBJECT_API_NAME
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: salesforce-describe-mcp
    port: 9090
    transport: http
    description: MCP adapter for Salesforce — Describe. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: salesforce-describe-global
      description: Salesforce Describe Global
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.describeglobal
      with:
        Content-Type: tools.Content-Type
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-describe-event-felay-feedback
      description: Salesforce Describe Event Felay Feedback
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.describeeventfelayfeedback
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-describe-global-layouts
      description: Salesforce Describe Global Layouts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.describegloballayouts
      with:
        Content-Type: tools.Content-Type
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-sobject-describe
      description: Salesforce Sobject Describe
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.sobjectdescribe
      with:
        SOBJECT_API_NAME: tools.SOBJECT_API_NAME
        Content-Type: tools.Content-Type
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-describe-sobject-layouts
      description: Salesforce Describe Sobject Layouts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.describesobjectlayouts
      with:
        SOBJECT_API_NAME: tools.SOBJECT_API_NAME
        Content-Type: tools.Content-Type
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-describe-sobject-layouts-per
      description: Salesforce Describe Sobject Layouts Per Record Type
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.describesobjectlayoutsperrecordtype
      with:
        SOBJECT_API_NAME: tools.SOBJECT_API_NAME
        RECORD_TYPE_ID: tools.RECORD_TYPE_ID
        Content-Type: tools.Content-Type
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-list-view-describe
      description: Salesforce List View Describe
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.listviewdescribe
      with:
        SOBJECT_API_NAME: tools.SOBJECT_API_NAME
        QUERY_LOCATOR: tools.QUERY_LOCATOR
        Content-Type: tools.Content-Type
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-embedded-service-configuration-describe
      description: Salesforce Embedded Service Configuration Describe
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.embeddedserviceconfigurationdescribe
      with:
        EMBEDDED_SERVICE_CONFIG_DEVELOPERNAME: tools.EMBEDDED_SERVICE_CONFIG_DEVELOPERNAME
        Content-Type: tools.Content-Type
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-get-tooling-describe
      description: Salesforce Get Tooling Describe
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.gettoolingdescribe
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-describe-event-relay
      description: Salesforce Describe Event Relay
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.describeeventrelay
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-describe-managed-event-subscription
      description: Salesforce Describe Managed Event Subscription
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.describemanagedeventsubscription
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-describe-event-channel
      description: Salesforce Describe Event Channel
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.describeeventchannel
      outputParameters:
      - type: object
        mapping: $.
    - name: salesforce-get-tooling-describe-sobject
      description: Salesforce Get Tooling Describe Sobject
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: salesforce-describe.gettoolingdescribesobject
      with:
        SOBJECT_API_NAME: tools.SOBJECT_API_NAME
      outputParameters:
      - type: object
        mapping: $.