The SDK is currently in active development. For more details, see the U301 Postman docs.

AI Integrations

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.txt gives 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

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.

u301-llms-full.txt
https://u301.com/docs/llms-full.txt

Ask 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: DOMAIN for your short domain and WORKSPACE_ID for 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

FieldRequiredDescription
urlYesThe destination URL to shorten.
slugNoA custom path for the short link.
expiredAtNoExpiration time in ISO format, such as 2026-03-13T00:00:00Z.
passwordNoPassword protection for the short link.
commentNoInternal 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.md
  • skills/u301-url-shortener-cli/SKILL.md
  • skills/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 u301

You can verify the install with:

u301 version
u301 help
u301 status --offline

Log 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 login and follow the prompts for apiKey and workspaceId
  • Or set U301_API_KEY and U301_WORKSPACE_ID in your shell environment

Example:

u301 login
u301 status --offline

Without 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-cli skill to shorten https://example.com with the slug launch."
  • "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