Checking status...

MCP

First-party AI integration that just works.

Desktop Extension

First-party MCP

MIT License

TypeScript

🚀 New: Claude Desktop Extension

Skip the terminal. Install our Desktop Extension in seconds and start shortening links with natural language.

Download Desktop Extension →

Requires Claude Desktop 0.12.0+

Choose your installation method

For Claude Desktop Users

Perfect if you want the easiest setup

One-click installation
No terminal required
Auto-updates

Use Desktop Extension →

For Developers

Full control over configuration

Works with any MCP client
Custom configuration
Version control friendly

Use npm package →

For Power Users

Run from source or fork

Modify and extend
Latest features
Contribute back

View on GitHub →

Real-World Use Cases

Content Creation

AI agents automatically shorten URLs in social media posts, newsletters, and blog content

“Hey Claude, I'm writing a Twitter thread about web development. Can you shorten these GitHub repo links for me?”

Analytics Reporting

Get real-time click data and insights without leaving your AI conversation

“Show me the analytics for all the links I shared in yesterday's campaign”

Bulk Operations

Process multiple URLs at once for documentation, resource lists, or link collections

“I have a list of 20 documentation links. Please shorten them all and organize them by category”

Available Tools

shorten_url

Create a shortened URL using tny.dev. Pass the full URL you want to shorten in the 'url' parameter.

urlstringrequired- The URL to shorten

customSlugstring- Optional custom slug (3-50 chars, alphanumeric, hyphens, underscores)

domainIdstring- Optional domain ID for custom domain usage (required when using customSlug)

get_link_analytics

Get click analytics for a shortened link

slugstringrequired- The slug of the shortened URL to get analytics for

list_links

List all shortened links created with your API key

pagenumber- Page number (default: 1)

limitnumber- Number of links per page (1-100, default: 20)

Desktop Extension (Recommended)

1. Download the extension

Get the latest .dxt file from our GitHub releases:

Download tnydev-mcp.dxt

2. Install in Claude Desktop

Simply drag and drop the .dxt file onto Claude Desktop, or use File → Install Extension.

💡 Requires Claude Desktop 0.12.0+

3. Configure with your API key

After installation, click the settings icon next to the extension and add:

• API Key: Your tny.dev API key (starts with tnyl_)
• Default Domain ID: Optional - for custom domains (Developer plan)
• Base URL: Leave as default unless self-hosting

4. Start using natural language

“Hey Claude, shorten this URL for me: https://example.com/very-long-path”

npm Package (Advanced)

1. Install via npm

Use directly with npx or install globally:

npx @specstory/tnydev-mcp

2. Configure your MCP client

Add to your claude_desktop_config.json or client configuration:

{
  "mcpServers": {
    "tny-dev": {
      "command": "npx",
      "args": ["-y", "@specstory/tnydev-mcp"],
      "env": {
        "TNY_DEV_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Advanced configuration

Add optional environment variables for custom domains (Developer plan):

"TNY_DEV_DEFAULT_DOMAIN_ID": "dom_your_domain_id"

Compatible AI Clients

Claude Desktop

Cursor

VS Code

Zed

Claude Code

Any MCP Client

Why developers choose tny.dev

First-party support

Official MCP server maintained by tny.dev. No third-party dependencies or community forks.

Open source

MIT licensed and fully open source. Fork, modify, and contribute back to help improve the MCP ecosystem.

Enterprise-grade reliability

Built on the same infrastructure that powers millions of shortened links. TypeScript for type safety.

Get Started →API Documentation →View on GitHub →