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