Expose APIs via MCP (Beta)

Our solution for exposing APIs via MCP (Model Context Protocol) allows you to easily expose your APIs managed in API Management (Sensedia Platform) as an MCP server, so that LLM-based agents can integrate with them effortlessly.

What is MCP?

MCP is an open protocol designed to facilitate the interaction between large language models (LLMs) and APIs by providing a standardized way to expose APIs as tools that AI agents can consume. It is an efficient and secure way to provide context to LLMs.

This way, MCP makes it possible to make your APIs understandable and discoverable to AI agents while making it easier for non-technical users to access its resources through natural language.

How our solution works

The solution is implemented as an API (MCP Admin) you can call to expose APIs managed in API Management (Sensedia Platform) via MCP.

Only APIs following the OpenAPI 3.0.x specifications can be exposed with this solution.

To use the MCP Admin API, you first need to import it into your Platform by following the steps below:

Importing the API
  1. Download the API documentation.

  2. Unzip the mcp_admin_v1.zip folder.

  3. Import the mcp.yaml file into the Platform by using the Import/Export feature.

  4. Deploy the API in an environment.

Once the MCP Admin API is imported into your environment, you can use it to expose your APIs via MCP by following these steps:

Exposing APIs via MCP
  1. Store the revision IDs of the APIs you would like to expose. The revision ID of an API corresponds to the last element of its URL, which is found when you click on the API’s name in its card at the API Catalog screen:

    Example of how to obtain an API’s revision ID
  2. Send a POST request to the /servers endpoint of the MCP Admin API passing in the body an array with the revision IDs of the APIs you want to expose. See the API reference below.

  3. If the request is successful, the API operations are exposed as tools in the MCP server created. The AI agents can then send requests to these tools to consume the APIs.

API reference - MCP Admin API

Endpoint

  • POST /servers

This endpoint takes an array of API revision IDs and creates a new MCP server that exposes the APIs' operations as tools. It is callable from the following URL:

POST https://<your-tenant>.sensedia.com/mcp-admin/v1/servers

Replace <your-tenant> with your tenant name.

Request body

The body must be in JSON format and include a revisions key with an array of integer API revision IDs.

Example:

{
  "revisions": [3174, 3151]
}

Response

Success

Code Description

204

No Content - The request was successful, and no additional content is returned.

Error Responses

Code Description

400

Bad Request (invalid input)

401

Unauthorized (invalid or missing token)

500

Internal Server Error

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]