Articles in this section

Create MCP servers

Teena Killa
Updated

Before you begin

  • You must be an account owner or admin to create an MCP server or manage tools.

  • You’ll need at least one API to expose it as a MCP tool.

  • You must create an account alias before creating an MCP Server.

Create a new MCP server

You can create a new MCP server from AI studio.

  1. Navigate to AI studio → MCP server. If you don’t have any existing servers click Create MCP server.

    CreateMCPserver_new2.jpg

    If you have previously created a server, click + Create MCP server in the upper right side of the page.

  2. In the Create new MCP enter the following required details:

    • Name your MCP server - Name your MCP server to reference it from other parts of the application.

    • Description (optional) - Enter a clear and concise description of your MCP server to help your AI agents and others understand its purpose. Keep this description updated as you make changes.

    • Relative URI - Use this field to define a unique Relative URI or the path of your MCP server within your account. The field value should start with “/” and cannot be empty.

    CreateMCPserver_details.jpg

  3. On the right side, In the Tools section click Add tools.

    MCPserver_addtools_.jpg

  4. In the Add tools page, select the APIs you want to expose as MCP tools from the available list or search to select.

    Note

    All the prebuilt APIs are available for you to select.

  5. Select the APIs from the available list or search to select and click Save. On saving, the page name changes from Create MCP server to Edit MCP server.

  6. You must assign an access token to invoke the MCP server. To add, click the Access token tab and select from the existing list or if you wish to create a new token click Create token.

    If you have not previously created an API token, click + Create token in the upper right side of the page.

    create_Access_token.jpg

  7. In the Create token, under How would you like to build the API? select any of the following Option:

    API token

    In the General, provide a name, an optional description and click in the Auto purge token field to select the required time to purge. Click Save & close. The API token is directly added to the MCP server.

    Note

    The newly created API token is also available in the Home → Resources → API token page.

    OAuth

    Select OAuth and configure the following fields. This is used to validate access tokens issued by an Identity Provider (Authorization Server). This is recommended for enterprise deployments and user-delegated access.

    • How would you like to build the API section?

    • Configure authentication

    • Authorization mapping

    • Advanced settings

  8. Click Close. The MCP server is now listed in the MCP servers page. It's a good practice to enable and test the MCP server.

Enable and test MCP server

Once you save, the MCP server will be created and you can see it on the MCP servers page. To enable the MCP server:

  1. Navigate to AI Studio → MCP servers.

  2. Locate the MCP server that you wish to enable from the MCP server list.

  3. Use the enable or disable the toggle associated with the server.

  4. Confirm the action when prompted.

Note

Disabling a server immediately prevents the execution of all downstream calls.

  • All flows or agents calling a disabled MCP server will receive an error.

  • Tools remain visible in the tool list but are non-callable.

In the MCP server page, open an existing MCP Server, click Test server to validate if your MCP server is created properly or not. You should see a list of tools in a JSON packet that you added in your MCP server. This action works the same as making a call to the list or tools endpoint on the MCP server.

Note

The MCP server must be enabled before you can test it.

Add an API to a new or existing MCP server

You can publish an existing API as an MCP tool from the API resource itself.

  1. Navigate to Resources → API → Actions (...) → Add to MCP server.

    AddMCPserver.jpg

  2. Choose one option:

    • Create new MCP server: If you want, create a new server and add the selected API as a tool.

    • Add to existing MCP server: Adds the selected API to an existing server.

Add an API to existing MCP server

Use the following steps to add an existing one:

  1. Navigate to Resources → API → Actions (...) → Add to MCP server. Then, select Add to existing MCP under the Options field.

    createexistingMCPserver.jpg

    Note

    Select MCP server field is available only on selecting Add to existing MCP option.

  2. Select an MCP server from the Select MCP server drop down and click Add to MCP.

  3. The Edit MCP server page is displayed. Click Save & close.

  4. Once you save, the MCP server is created and you can see it in the MCP server page. It's a good practice to enable and then test the MCP server.

Add APIs as MCP tools

The Tools section on the right side of the Create MCP server page allows you to add APIs as MCP tools. You can use the search option to find tools and APIs based on .

  1. Click Add tools.

  2. Select from the list of APIs or use search to find specific tools that you want to add as MCP tools.

  3. Click the view icon adjacent to each tool or API and view it in the flow builder and close it.

    viewtool_flow.jpg

  4. Click Save.

All the selected APIs are added to the MCP server. For each tool you have options to:

Tool_options.jpg

  • Enable/Disable

  • View - Click to view it in the flow builder and close it.

  • Delete - Click to delete the tool.

  • Configure - Click the gear icon to rename the tool and click Save.

    configuretool_API.jpg