Connect U301 to AI assistants with LLMs.txt, the official MCP server, and reusable CLI skills.
U301 can be plugged into AI tools in three complementary ways:
LLMs.txtgives assistants a clean, low-token view of the docs.- The official MCP server lets AI clients create short links directly.
- Reusable skills teach compatible agents how to install and operate the U301 CLI.
LLMs.txt
Load the full U301 docs as plain Markdown.
MCP Server
Connect U301 short-link creation to Cursor, Windsurf, and other MCP clients.
Skills
Reuse the packaged CLI skill for agents that support AGENTS.md and SKILL.md.
LLMs.txt
LLMs.txt is a small, plain-text companion to your docs. It gives AI assistants a single, clean source of truth about your library. Point tools like Cursor, ChatGPT, Claude, or Copilot to this text and they will understand your concepts, APIs, and examples much more reliably.
https://u301.com/docs/llms-full.txtAsk Bender
Bender is our AI assistant listed on the GPT Store. It loads LLMs.txt, pulls answers from our documentation, and responds based on that context. We recommend using a thinking-capable model for best results; Instant makes more mistakes. Each page includes a button at the top. Click it to use Bender with this page's content.
You can also open Bender directly on ChatGPT: https://chatgpt.com/g/g-69118c1d8974819196445be466120f24-bender-from-u301
Why it helps
LLMs.txt is just text. It's structured and predictable so models can scan it quickly.
- Plain text: easy to fetch, paste, and index.
- Stable URL: a single link you can reference in prompts and tools.
- Headings first: page titles and sections come before content for fast retrieval.
- No styling: content only, which reduces token waste.
In this documentation, LLMs.txt is automatically generated from the same source, so it stays in sync when page content changes.
Use it
- https://u301.com/docs/llms-full.txt returns the full docs as plain Markdown.
- Add it as docs context in Cursor with
@Docs. - Paste it into a chat when you want an assistant to answer from the latest U301 docs.
MCP Server
The official U301 MCP server lives in tealight-uk/u301-mcp. It runs as a stdio MCP server and exposes the u301_shortening_urls_in_bulk tool so compatible AI clients can create short links for you.
Before you start
- A U301 API key from U301 Dashboard
- Node.js 22 or newer available to your MCP client
- Optional defaults:
DOMAINfor your short domain andWORKSPACE_IDfor a specific workspace
Install and connect
The recommended setup is to let your MCP client run the package with npx, so there is no separate global install step:
{
"mcpServers": {
"u301-url-shortener": {
"command": "npx",
"args": ["-y", "@u301/mcp"],
"env": {
"U301_API_KEY": "<YOUR_U301_API_KEY>",
// "DOMAIN": "go.example.com",
// "WORKSPACE_ID": "<OPTIONAL_WORKSPACE_ID>"
}
}
}
}After saving the config, restart your AI client and ask it to shorten URLs for you.
Supported fields
| Field | Required | Description |
|---|---|---|
url | Yes | The destination URL to shorten. |
slug | No | A custom path for the short link. |
expiredAt | No | Expiration time in ISO format, such as 2026-03-13T00:00:00Z. |
password | No | Password protection for the short link. |
comment | No | Internal note shown in the U301 dashboard. |
The server accepts up to 200 URLs in one request. If DOMAIN is not set, the package falls back to u301.co.
Example prompts
- "Shorten the URLs in this file and keep the slugs readable."
- "Create short links for these launch pages on
go.example.com." - "Replace the long URLs in the comments of this file with memorable short URLs."
Skills
U301 also ships reusable AI skills in the u301-shortener/u301-js repository. The packaged skill is u301-url-shortener-cli, and it teaches compatible agents how to install the u301 CLI, check auth, create links, manage domains, and fetch analytics.
Files to reuse
If your assistant supports repository-local skills via AGENTS.md and SKILL.md, copy or reuse these files from the repo:
AGENTS.mdskills/u301-url-shortener-cli/SKILL.mdskills/u301-url-shortener-cli/references/cli-cheatsheet.md
The exact install path depends on the assistant you use, but those files are the portable pieces.
Install the CLI
The skill expects the u301 command to be available locally. Install it with the package manager you already use:
npm install -g u301
pnpm add -g u301
yarn global add u301
bun add -g u301You can verify the install with:
u301 version
u301 help
u301 status --offlineLog in first
Before asking an assistant to use the skill, make sure the CLI is authenticated with both your API key and workspace ID.
You can do that in either of these ways:
- Run
u301 loginand follow the prompts forapiKeyandworkspaceId - Or set
U301_API_KEYandU301_WORKSPACE_IDin your shell environment
Example:
u301 login
u301 status --offlineWithout apiKey and workspaceId, the skill can install the CLI and explain commands, but it cannot call the U301 API for real link, domain, or analytics operations.
Install the skill in your project
npx skills add u301-shortener/u301-js
The AI assistant can also install this skill for you.
Use the skill
Once the skill files are available to your assistant, you can ask for tasks such as:
- "Use the
u301-url-shortener-cliskill to shortenhttps://example.comwith the sluglaunch." - "Check whether my U301 CLI is logged in."
- "List my short links."
- "Show top countries for the last 30 days."
Under the hood, the skill is built around the current U301 CLI workflow, including commands like u301 shorten, u301 links ..., u301 domains ..., and u301 analytics ....
Last updated on