Creating MCP tools

About this task

Use API Studio to generate MCP tools from your existing OpenAPI definitions. You can choose specific operations to expose, and API Studio automatically packages the tools into a runnable MCP server.

Procedure

  1. From the home page, select an API project that contains the OpenAPI document you want to use for MCP tool generation.
    The project opens in the Development tab, where API Studio detects all available operations defined in the specification.
  2. Click the Create MCP tools icon.
  3. On the Create MCP tools page, review the list of paths and operations. Select the operations that you want to include in the MCP tool, then click Continue.
  4. On the Add details page, enter the required metadata for the MCP server and tool files.
    • Name. Enter a name for the MCP server and tool.
    • Namespace. Specify the namespace for the MCP server and the tool.
    • API version. Enter the version of the API.
    • Tags. Add any relevant tags for discovery or classification.
  5. Click Continue.
    API Studio generates the MCP server and MCP tool files based on the operations you selected.
  6. Select the generated MCP server file and click the Download MCP server icon.

    A .zip file is downloaded to your local system. This file contains:

    • A startup file for the MCP server, specific to your operating system
    • A resources folder that contains the tool definitions

What to do next

  • Run the startup file from a terminal or command prompt window, depending on your operating system. This action launches the MCP server.

    When the server starts, it registers all the selected tools. The server exposes each selected path from the OpenAPI definition as an MCP tool.

  • After the server is up, you can see all selected operations registered as MCP tools. AI agents can inspect and invoke these tools. While API Studio does not display the active tools directly, you can access them through agents such as Claude Desktop or other AI platforms that support MCP integration.