Blog

Naftiko Capabilities for APIPark

·April 28, 2026
Table of contents

APIPark is an open-source AI gateway and developer platform that combines API management with AI model access management. It is built specifically for organizations that publish both traditional REST APIs and AI model endpoints to internal teams and external developers. The Naftiko capability for APIPark exposes the platform’s service, model, team, and subscriber surfaces as MCP tools.

What the Capability Covers

The platform-management capability wraps the APIPark API and covers the four core governance objects: published services, available AI models, registered teams, and active subscribers.

MCP Tools Available

  • list-services — List all API services published on the APIPark developer platform
  • create-service — Publish a new API service on the platform
  • list-ai-models — List all AI models available including provider and capabilities
  • list-teams — List all teams with their members and permissions
  • list-subscribers — List all API subscribers and their active subscriptions

Capability Specification

naftiko: "1.0.0-alpha1"

info:
  name: APIPark Platform Management
  description: Manage services, AI models, teams, and subscribers across the APIPark developer platform
  version: 1.0.0

capability:
  consumes:
    - namespace: apipark
      type: http
      baseUri: https://api.apipark.com
      authentication:
        type: bearer
        token: ""
      resources:
        - name: services
          path: "/v1/services"
          operations:
            - name: listServices
              method: GET
            - name: createService
              method: POST
        - name: ai-models
          path: "/v1/ai-models"
          operations:
            - name: listAiModels
              method: GET
        - name: teams
          path: "/v1/teams"
          operations:
            - name: listTeams
              method: GET
        - name: subscribers
          path: "/v1/subscribers"
          operations:
            - name: listSubscribers
              method: GET

  exposes:
    - type: mcp
      address: "0.0.0.0"
      port: 9131
      namespace: apipark-management
      description: "APIPark platform management  discover services, inspect AI models, list teams, and manage subscribers"
      tools:
        - name: list-services
          description: "List all API services published on the APIPark developer platform"
          hints:
            readOnly: true
          call: apipark.listServices
          outputParameters:
            - type: array
              mapping: "$."
              items:
                type: object

        - name: create-service
          description: "Publish a new API service on the APIPark platform"
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: apipark.createService
          inputParameters:
            - name: body
              type: object
              required: true
              description: "Service definition including name, description, and API configuration"
          outputParameters:
            - type: object
              mapping: "$."

        - name: list-ai-models
          description: "List all AI models available on the APIPark platform including provider and capabilities"
          hints:
            readOnly: true
          call: apipark.listAiModels
          outputParameters:
            - type: array
              mapping: "$."
              items:
                type: object

        - name: list-teams
          description: "List all teams registered on the APIPark platform with their members and permissions"
          hints:
            readOnly: true
          call: apipark.listTeams
          outputParameters:
            - type: array
              mapping: "$."
              items:
                type: object

        - name: list-subscribers
          description: "List all API subscribers and their active subscriptions on the APIPark platform"
          hints:
            readOnly: true
          call: apipark.listSubscribers
          outputParameters:
            - type: array
              mapping: "$."
              items:
                type: object

Running It

docker pull ghcr.io/naftiko/framework:latest

# Set APIPARK_API_KEY in your .env file
docker run -p 9131:9131 \
  -v ./capabilities/platform-management.yaml:/app/capability.yaml \
  --env-file .env \
  ghcr.io/naftiko/framework:latest /app/capability.yaml

The list-ai-models tool alongside list-services creates a unified discovery surface: an agent can enumerate AI capabilities available, correlate them with published services, and understand which teams are consuming what. The APIPark capability is part of the Naftiko Fleet.