Server data from the Official MCP Registry
Ephemeral, human-friendly short URLs for Tollbooth MCP services
About
Ephemeral, human-friendly short URLs for Tollbooth MCP services
Remote endpoints: streamable-http: https://tollbooth-shortlinks.fastmcp.app/mcp
Security Report
Tollbooth Shortlinks is a well-structured MCP server for ephemeral URL shortening with reasonable security practices. The service properly manages database credentials via environment variables, implements appropriate input handling for SQL operations via parameterized queries, and has no authentication requirements suitable for its use case as a community utility. Minor code quality concerns around broad exception handling and lack of slug validation do not significantly impact security. Supply chain analysis found 5 known vulnerabilities in dependencies (1 critical, 3 high severity).
6 files analyzed · 11 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install & Connect
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
Documentation
View on GitHubFrom the project's GitHub README.
Tollbooth Shortlinks
Don't Pester Your Customer™ (DPYC™) — Ephemeral, human-friendly short URLs for the Tollbooth ecosystem.
The metaphors in this project are drawn with admiration from The Phantom Tollbooth by Norton Juster, illustrated by Jules Feiffer (1961). Milo, Tock, the Tollbooth, Dictionopolis, and Digitopolis are creations of Mr. Juster's extraordinary imagination. We just built the payment infrastructure.
Why This Exists
OAuth Authorization URLs are long, ugly, and hostile to copy-paste:
https://api.schwab.com/v1/oauth/authorize?client_id=abc123&redirect_uri=https%3A%2F%2F
fastmcp.cloud%2Foauth%2Fcallback%3Fserver_id%3D...&scope=...&response_type=code&state=...
Traditional link shorteners have become opinionated. They inject interstitial pages, track clicks, require accounts, gate features behind paywalls, or silently expire links on their own schedule. When an MCP server needs to hand a patron a one-time URL for an OAuth dance, none of that belongs in the path.
Tollbooth Shortlinks is a community utility with no monetization. It turns
any URL into a memorable four-word phrase like brave-otter-finds-gold, stores
the mapping in Neon Postgres, and expires it after 24 hours. A companion
Val Town HTTP handler does the 302 redirect with zero interstitial.
How It Works
MCP Server Shortlinks MCP Val Town
| | |
|-- create_shortlink(url) ---->| |
|<-- brave-otter-finds-gold ---| |
| | |
| (patron clicks short URL) | |
| | GET /brave-otter-.. |
| |<------------------------|
| | Neon lookup |
| |-- 302 redirect -------->|
| | |
| (24h later) | |
| | link expires silently |
Tools
| Tool | Description |
|---|---|
create_shortlink | Store a URL, get back a memorable slug (or supply your own) |
resolve_shortlink | Look up where a slug points without redirecting |
delete_shortlink | Remove a shortlink before it expires |
shortlink_status | Health check showing active link count and TTL |
All tools are free -- no credits, no npub, no Tollbooth ledger required.
Install
pip install -e ".[dev]"
Run Locally
export NEON_SHORTLINKS_URL="postgres://user:pass@ep-xyz.us-east-2.aws.neon.tech/shortlinks"
python -c "from server import mcp; mcp.run()"
Deploy to Horizon
The .fastmcp.yaml at the repo root is ready for fastmcp deploy.
DPYC Identity
Tollbooth Shortlinks is registered as an Advocate in the DPYC Social Contract. Peer MCP servers discover its URL via registry lookup:
from tollbooth import resolve_service_by_name
shortlinks_url = resolve_service_by_name("tollbooth-shortlinks")
redirect_base = resolve_service_by_name("tollbooth-shortlinks-redirect")
Related Repos
The Tollbooth DPYC™ ecosystem:
| Repo | Role |
|---|---|
| tollbooth-dpyc | The wheel -- operator-side credit ledger, BTCPay client, tool gating, constraint engine |
| tollbooth-authority | The institution -- fee collection, Schnorr signing, purchase certification |
| dpyc-oracle | The oracle -- Social Contract governance, membership, ban elections |
| dpyc-community | The registry -- governance data, operator catalog, community rules |
| tollbooth-sample | Reference operator -- weather API with full Tollbooth wiring |
| cypher-mcp | Monetized graph answers -- named Cypher over Neo4j/AuraDB |
| schwab-mcp | Charles Schwab brokerage MCP -- trading, quotes, portfolio access |
| excalibur-mcp | eXcalibur -- formatted posting to X (Twitter) |
| thebrain-mcp | Personal Brain MCP -- thought graphs, knowledge management |
| taxsort-mcp | Tax sorting and classification MCP |
| optionality-mcp | Options analytics MCP |
| tollbooth-shortlinks (this repo) | Community utility -- ephemeral short URLs for OAuth flows |
| tollbooth-oauth2-collector | OAuth2 callback collector -- browser-based token exchange |
| tollbooth-pricing-studio | iOS app -- operator dashboard and pricing model editor |
License
Apache-2.0. See LICENSE for details.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption