naftiko: 1.0.0-alpha2
info:
  label: Pinecone Admin API
  description: Provides an API for managing a Pinecone organization and its resources.
  tags:
  - Pinecone
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: pinecone
    baseUri: https://api.pinecone.io
    description: Pinecone Admin API HTTP API.
    authentication:
      type: bearer
      token: '{{PINECONE_TOKEN}}'
    resources:
    - name: admin-projects
      path: /admin/projects
      operations:
      - name: list-projects
        method: GET
        description: List projects
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-project
        method: POST
        description: Create a new project
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-organizations
      path: /admin/organizations
      operations:
      - name: list-organizations
        method: GET
        description: List organizations
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-projects-project-id
      path: /admin/projects/{project_id}
      operations:
      - name: fetch-project
        method: GET
        description: Get project details
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: project_id
          in: path
          type: string
          required: true
          description: Project ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete-project
        method: DELETE
        description: Delete a project
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: project_id
          in: path
          type: string
          required: true
          description: Project ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-project
        method: PATCH
        description: Update a project
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: project_id
          in: path
          type: string
          required: true
          description: Project ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-organizations-organization-id
      path: /admin/organizations/{organization_id}
      operations:
      - name: fetch-organization
        method: GET
        description: Get organization details
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: organization_id
          in: path
          type: string
          required: true
          description: Organization ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete-organization
        method: DELETE
        description: Delete an organization
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: organization_id
          in: path
          type: string
          required: true
          description: Organization ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-organization
        method: PATCH
        description: Update an organization
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: organization_id
          in: path
          type: string
          required: true
          description: Organization ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-projects-project-id-api-keys
      path: /admin/projects/{project_id}/api-keys
      operations:
      - name: list-project-api-keys
        method: GET
        description: List API keys
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: project_id
          in: path
          type: string
          required: true
          description: Project ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-api-key
        method: POST
        description: Create an API key
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: project_id
          in: path
          type: string
          required: true
          description: Project ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-api-keys-api-key-id
      path: /admin/api-keys/{api_key_id}
      operations:
      - name: fetch-api-key
        method: GET
        description: Get API key details
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: api_key_id
          in: path
          type: string
          required: true
          description: API key ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: delete-api-key
        method: DELETE
        description: Delete an API key
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: api_key_id
          in: path
          type: string
          required: true
          description: API key ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-api-key
        method: PATCH
        description: Update an API key
        inputParameters:
        - name: X-Pinecone-Api-Version
          in: header
          type: string
          required: true
          description: Required date-based version header
        - name: api_key_id
          in: path
          type: string
          required: true
          description: API key ID
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: pinecone-rest
    description: REST adapter for Pinecone Admin API.
    resources:
    - path: /admin/projects
      name: list-projects
      operations:
      - method: GET
        name: list-projects
        description: List projects
        call: pinecone.list-projects
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/projects
      name: create-project
      operations:
      - method: POST
        name: create-project
        description: Create a new project
        call: pinecone.create-project
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/organizations
      name: list-organizations
      operations:
      - method: GET
        name: list-organizations
        description: List organizations
        call: pinecone.list-organizations
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/projects/{project_id}
      name: fetch-project
      operations:
      - method: GET
        name: fetch-project
        description: Get project details
        call: pinecone.fetch-project
        with:
          project_id: rest.project_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/projects/{project_id}
      name: delete-project
      operations:
      - method: DELETE
        name: delete-project
        description: Delete a project
        call: pinecone.delete-project
        with:
          project_id: rest.project_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/projects/{project_id}
      name: update-project
      operations:
      - method: PATCH
        name: update-project
        description: Update a project
        call: pinecone.update-project
        with:
          project_id: rest.project_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/organizations/{organization_id}
      name: fetch-organization
      operations:
      - method: GET
        name: fetch-organization
        description: Get organization details
        call: pinecone.fetch-organization
        with:
          organization_id: rest.organization_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/organizations/{organization_id}
      name: delete-organization
      operations:
      - method: DELETE
        name: delete-organization
        description: Delete an organization
        call: pinecone.delete-organization
        with:
          organization_id: rest.organization_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/organizations/{organization_id}
      name: update-organization
      operations:
      - method: PATCH
        name: update-organization
        description: Update an organization
        call: pinecone.update-organization
        with:
          organization_id: rest.organization_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/projects/{project_id}/api-keys
      name: list-project-api-keys
      operations:
      - method: GET
        name: list-project-api-keys
        description: List API keys
        call: pinecone.list-project-api-keys
        with:
          project_id: rest.project_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/projects/{project_id}/api-keys
      name: create-api-key
      operations:
      - method: POST
        name: create-api-key
        description: Create an API key
        call: pinecone.create-api-key
        with:
          project_id: rest.project_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/api-keys/{api_key_id}
      name: fetch-api-key
      operations:
      - method: GET
        name: fetch-api-key
        description: Get API key details
        call: pinecone.fetch-api-key
        with:
          api_key_id: rest.api_key_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/api-keys/{api_key_id}
      name: delete-api-key
      operations:
      - method: DELETE
        name: delete-api-key
        description: Delete an API key
        call: pinecone.delete-api-key
        with:
          api_key_id: rest.api_key_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /admin/api-keys/{api_key_id}
      name: update-api-key
      operations:
      - method: PATCH
        name: update-api-key
        description: Update an API key
        call: pinecone.update-api-key
        with:
          api_key_id: rest.api_key_id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: pinecone-mcp
    transport: http
    description: MCP adapter for Pinecone Admin API for AI agent use.
    tools:
    - name: list-projects
      description: List projects
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pinecone.list-projects
      outputParameters:
      - type: object
        mapping: $.
    - name: create-project
      description: Create a new project
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pinecone.create-project
      outputParameters:
      - type: object
        mapping: $.
    - name: list-organizations
      description: List organizations
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pinecone.list-organizations
      outputParameters:
      - type: object
        mapping: $.
    - name: fetch-project
      description: Get project details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pinecone.fetch-project
      with:
        project_id: tools.project_id
      inputParameters:
      - name: project_id
        type: string
        description: Project ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-project
      description: Delete a project
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: pinecone.delete-project
      with:
        project_id: tools.project_id
      inputParameters:
      - name: project_id
        type: string
        description: Project ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: update-project
      description: Update a project
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pinecone.update-project
      with:
        project_id: tools.project_id
      inputParameters:
      - name: project_id
        type: string
        description: Project ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: fetch-organization
      description: Get organization details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pinecone.fetch-organization
      with:
        organization_id: tools.organization_id
      inputParameters:
      - name: organization_id
        type: string
        description: Organization ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-organization
      description: Delete an organization
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: pinecone.delete-organization
      with:
        organization_id: tools.organization_id
      inputParameters:
      - name: organization_id
        type: string
        description: Organization ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: update-organization
      description: Update an organization
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pinecone.update-organization
      with:
        organization_id: tools.organization_id
      inputParameters:
      - name: organization_id
        type: string
        description: Organization ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: list-project-api-keys
      description: List API keys
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pinecone.list-project-api-keys
      with:
        project_id: tools.project_id
      inputParameters:
      - name: project_id
        type: string
        description: Project ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: create-api-key
      description: Create an API key
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pinecone.create-api-key
      with:
        project_id: tools.project_id
      inputParameters:
      - name: project_id
        type: string
        description: Project ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: fetch-api-key
      description: Get API key details
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: pinecone.fetch-api-key
      with:
        api_key_id: tools.api_key_id
      inputParameters:
      - name: api_key_id
        type: string
        description: API key ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-api-key
      description: Delete an API key
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: pinecone.delete-api-key
      with:
        api_key_id: tools.api_key_id
      inputParameters:
      - name: api_key_id
        type: string
        description: API key ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: update-api-key
      description: Update an API key
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: pinecone.update-api-key
      with:
        api_key_id: tools.api_key_id
      inputParameters:
      - name: api_key_id
        type: string
        description: API key ID
        required: true
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    PINECONE_TOKEN: PINECONE_TOKEN