naftiko: "1.0.0-alpha2" info: title: Gravitee MCP Tool Server Register description: >- Registers Naftiko-built MCP servers with Gravitee's MCP Tool Server (the Enterprise AI Agent Management module that exposes managed APIs as MCP tools to AI agents). When Naftiko ships an `exposes: mcp` capability, this capability publishes the MCP server registration so Gravitee MCP Resource Server v2 enforces auth + token tracking + guard-rails on agent traffic to it. tags: - Naftiko - Gravitee - Partnership - MCP - AI-Agent-Management - Tool-Server created: '2026-05-15' modified: '2026-05-15' binds: - namespace: gravitee-env description: Gravitee APIM Management endpoint + token. keys: GRAVITEE_APIM_BASE: GRAVITEE_APIM_BASE GRAVITEE_APIM_TOKEN: GRAVITEE_APIM_TOKEN capability: consumes: - namespace: gravitee type: http baseUri: '{{GRAVITEE_APIM_BASE}}' authentication: type: bearer token: '{{GRAVITEE_APIM_TOKEN}}' resources: - name: list-mcp-servers path: '/management/v2/environments/{{env_id}}/mcp/servers' operations: - name: list-mcp-servers method: GET inputParameters: - { name: env_id, in: path, required: true } - name: register-mcp-server method: POST inputParameters: - { name: env_id, in: path, required: true } - name: mcp-server path: '/management/v2/environments/{{env_id}}/mcp/servers/{{server_id}}' operations: - name: get-mcp-server method: GET inputParameters: - { name: env_id, in: path, required: true } - { name: server_id, in: path, required: true } - name: update-mcp-server method: PUT inputParameters: - { name: env_id, in: path, required: true } - { name: server_id, in: path, required: true } - name: delete-mcp-server method: DELETE inputParameters: - { name: env_id, in: path, required: true } - { name: server_id, in: path, required: true } - name: mcp-tools path: '/management/v2/environments/{{env_id}}/mcp/servers/{{server_id}}/tools' operations: - name: list-mcp-tools method: GET inputParameters: - { name: env_id, in: path, required: true } - { name: server_id, in: path, required: true } - name: publish-mcp-tool method: POST inputParameters: - { name: env_id, in: path, required: true } - { name: server_id, in: path, required: true } exposes: - type: rest address: 0.0.0.0 port: 8080 namespace: gravitee-mcp-tool-server-register-rest description: REST surface for managing Gravitee MCP Tool Server registrations. resources: - name: mcp-servers path: '/environments/{env_id}/mcp-servers' operations: - name: list-mcp-servers method: GET inputParameters: - { name: env_id, in: path, type: string, required: true } call: gravitee.list-mcp-servers - name: register-mcp-server method: POST inputParameters: - { name: env_id, in: path, type: string, required: true } call: gravitee.register-mcp-server - name: mcp-server path: '/environments/{env_id}/mcp-servers/{server_id}' operations: - name: get-mcp-server method: GET inputParameters: - { name: env_id, in: path, type: string, required: true } - { name: server_id, in: path, type: string, required: true } call: gravitee.get-mcp-server - name: update-mcp-server method: PUT inputParameters: - { name: env_id, in: path, type: string, required: true } - { name: server_id, in: path, type: string, required: true } call: gravitee.update-mcp-server - name: delete-mcp-server method: DELETE inputParameters: - { name: env_id, in: path, type: string, required: true } - { name: server_id, in: path, type: string, required: true } call: gravitee.delete-mcp-server - name: mcp-tools path: '/environments/{env_id}/mcp-servers/{server_id}/tools' operations: - name: list-mcp-tools method: GET inputParameters: - { name: env_id, in: path, type: string, required: true } - { name: server_id, in: path, type: string, required: true } call: gravitee.list-mcp-tools - name: publish-mcp-tool method: POST inputParameters: - { name: env_id, in: path, type: string, required: true } - { name: server_id, in: path, type: string, required: true } call: gravitee.publish-mcp-tool - type: mcp address: 0.0.0.0 port: 3010 namespace: gravitee-mcp-tool-server-register-mcp description: MCP server for managing Gravitee MCP Tool Server registrations from agents. tools: - name: list-mcp-servers description: List MCP servers registered with Gravitee MCP Tool Server. hints: { readOnly: true } inputParameters: - { name: env_id, type: string, required: true } call: gravitee.list-mcp-servers - name: register-mcp-server description: Register a new MCP server with Gravitee Tool Server (typically a Naftiko-built MCP). hints: { destructiveHint: false } inputParameters: - { name: env_id, type: string, required: true } call: gravitee.register-mcp-server - name: get-mcp-server description: Get a single Gravitee-registered MCP server. hints: { readOnly: true } inputParameters: - { name: env_id, type: string, required: true } - { name: server_id, type: string, required: true } call: gravitee.get-mcp-server - name: update-mcp-server description: Update a Gravitee-registered MCP server. hints: { destructiveHint: true } inputParameters: - { name: env_id, type: string, required: true } - { name: server_id, type: string, required: true } call: gravitee.update-mcp-server - name: delete-mcp-server description: Deregister an MCP server from Gravitee Tool Server. hints: { destructiveHint: true } inputParameters: - { name: env_id, type: string, required: true } - { name: server_id, type: string, required: true } call: gravitee.delete-mcp-server - name: list-mcp-tools description: List MCP tools exposed by a Gravitee-registered MCP server. hints: { readOnly: true } inputParameters: - { name: env_id, type: string, required: true } - { name: server_id, type: string, required: true } call: gravitee.list-mcp-tools - name: publish-mcp-tool description: Publish a new MCP tool on a Gravitee-registered MCP server. hints: { destructiveHint: false } inputParameters: - { name: env_id, type: string, required: true } - { name: server_id, type: string, required: true } call: gravitee.publish-mcp-tool