# How to integrate and use Short.io with your MCP-enabled service

Copy for LLM[View as Markdown](/articles/integrations-and-extensions/direct-integrations/how-to-integrate-and-use-short.io-with-your-mcp-enabled-service.md)

You can integrate and use **Short.io** with an MCP-enabled service such as Claude Desktop, VS Code or another one of your choice which supports custom MCP server settings from a JSON file.

In the following instructions, we will use Claude Desktop for demonstration purposes.

## To enable the Short.io MCP server[​](#to-enable-the-shortio-mcp-server "Direct link to To enable the Short.io MCP server")

***

Open the Claude Desktop **Developer**->**Settings** menu and add the following configuration where **sk\_secret\_key** is your **Short.io** **\[API key]\(/articles/api-reference/Technical questions/how-to-use-the-short.io-api#h\_69a635db5a)**:

```
`{  
	"mcpServers": \{  
		"shortio": \{  
			"command": "npx",  
			"args": [  
				"mcp-remote",  
				"https://ai-assistant.short.io/mcp",  
				"--header",  
				"Authorization: $\{SHORTIO_API_KEY\}"  
			],  
			"env": \{  
				"SHORTIO_API_KEY": "sk_secret_key"  
			\}  
		\}  
	\}  
}`
```

![Claude Desktop Developer settings with Short.io MCP server](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1813-53-22-03bb4be5-2c699ea9a54c5092d1d21287f617ef24.png)

## To use the Short.io MCP server[​](#to-use-the-shortio-mcp-server "Direct link to To use the Short.io MCP server")

***

### Creating a short link[​](#creating-a-short-link "Direct link to Creating a short link")

1. Open Claude Desktop and start a new chat with a prompt similar to the following:

   ***Create a short link using the domain mybrand.bg and with the following settings: set slug and title to be summer-sale-50 and long URL to be <https://www.mybrand.bg/new-arrivals/summer-sale-50-percent-off>***

   ![Claude Desktop chat with short link creation prompt](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1715-40-07-4370279c-5ca73752d63911dbb11d05907bb1d5dd.png)

2. Wait a few moments for Claude to complete the task and display the result which includes detailed information on the created link:

   * **Short URL**

   * **Original URL**

   * **Title**

   * **Link ID**

   * **Created** (date)

   ![Claude Desktop showing created short link details](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1715-41-302-d0959d04-6f96b3447ab1eef41417d939eeebc9f4.png)

   The link has been successfully created:

   ![Short.io dashboard showing the created short link](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1715-44-13-85b5c935-419511fa826154c2ba0db5e0930a74fb.png)

Important note

With the current implementation of the **Short.io** MCP it is not possible to edit or delete an existing short link. In case you need to make any changes, please remove ***manually*** the old link from the **Short.io** Dashboard and create a new one including the necessary data.

### Simple use cases[​](#simple-use-cases "Direct link to Simple use cases")

***

#### Searching for specific links[​](#searching-for-specific-links "Direct link to Searching for specific links")

You can look for links which match certain criteria, *for example*:

**Can you find all the short links which contain the word "bags" in their title and their expiration date is before "2025-08-01T21:00:00.000Z"?**

![Short.io dashboard with links containing bags in title](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1811-50-48-ae5d3dfd-e985cfe327a3121218d46836183d4bd9.png)

![Short.io link expiration date settings dialog](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1812-14-16-ca377411-98b87c7e53ae9841dc621f16b9b16662.png)

![Claude Desktop chat with link search prompt](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1811-52-26-74aea214-440f014335f19bdfd889fdf71dcb7cab.png)

![Claude Desktop showing link search results](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1811-56-47-5b47d634-457e3e6d390d5cb84ef7de3f001c0810.png)

#### Getting analytics and top-performing metrics[​](#getting-analytics-and-top-performing-metrics "Direct link to Getting analytics and top-performing metrics")

With the help of **Short.io's** MCP, you can retrieve the top column statistics (countries, browsers, operating systems, UTM campaigns, etc.) for a given domain.

*For example*,

**Could you provide me with the top column statistics for the domain "mydomain.bg"? Specifically, I am looking for information on the top 3 countries, cities, and browsers.**

![Claude Desktop chat with statistics request prompt](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1812-49-25-e50080ae-6d766c14e5871037b3285b6f5af53343.png)

![Claude Desktop showing top statistics by country and browser](/assets/images/direct-integrations-how-to-integrate-and-use-short.io-with-your-mcp-enabled-service-screenshotfrom2025-07-1812-51-18-43ab0477-e88400bedfbda2e61946d48f897bc7a4.png)

#### Other Analytics & Statistics[​](#other-analytics--statistics "Direct link to Other Analytics & Statistics")

You can also prompt your MCP client to retrieve for you:

**Link statistics** - Detailed analytics for individual links including clicks, geographic data, devices, browsers, and referrers

**Domain statistics** - Comprehensive analytics for entire domains over specified time periods

**Top column by interval** - Time-series data showing how top values change over different intervals (hour, day, week, month)

**Link-specific top columns** - Top-performing metrics for individual links