Tollbooth Shortlinks

io.github.lonnievPublished by GitHub account lonnievv0.2.0Updated Oct 24, 2026

Ephemeral, human-friendly short URLs for Tollbooth MCP services

VerifiedStreamable HTTPWeb executableProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Turns long URLs into ephemeral four-word short links that expire after 24 hours, for OAuth and other one-time links.

What you can do
  • Create a shortlink from a URL, optionally with your own slug, and get back the full short URL
  • Look up where a slug points without following the redirect
  • Delete a shortlink before its 24-hour expiry
  • Check service health, active link count and TTL
When to use it
Useful when an assistant or MCP server needs to hand a person a short, copy-pasteable URL, such as an OAuth authorization link, without interstitial pages or click tracking. It is a small community utility rather than a general-purpose link manager.
Requirements
Remote endpoint over streamable HTTP; no authentication, environment variables or headers are declared. Running it locally instead needs Python, a Neon Postgres connection string in NEON_SHORTLINKS_URL, and optionally SHORTLINK_REDIRECT_BASE for the redirect host.
Before you install
Anyone who can reach the endpoint can create, resolve and delete shortlinks, and there is no declared authentication. Links are public and expire after 24 hours, so do not use them for secrets or anything that must stay reachable. Created URLs are stored in a third-party Postgres database, and the redirect is served by a separate Cloudflare Worker.

Installation

In SourceWeft

  1. Open Tollbooth Shortlinks in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.lonniev%2Ftollbooth-shortlinks/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "tollbooth-shortlinks": {
      "type": "http",
      "url": "https://tollbooth-shortlinks.fastmcp.app/mcp"
    }
  }
}

README

Tollbooth Shortlinks

[License] [Python]

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%2Ffastmcp.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 Cloudflare Worker does the 302 redirect with zero interstitial.

How It Works

MCP Server / Patron          Shortlinks MCP        Neon        CF Worker    |                              |                 |              |    |-- create_shortlink(url) ---->|-- INSERT ------>|              |    |<-- short_url ----------------|                 |              |    |                              |                 |              |    |-- GET /brave-otter-finds-gold ---------------------------->   |    |                              |                 |<-- lookup ---|    |<-- 302 redirect ----------------------------------------------|    |                              |                 |              |    |        (24h later)           |  expired rows are deleted      |

Tools

ToolDescription
create_shortlinkStore a URL, get back a memorable slug (or supply your own)
resolve_shortlinkLook up where a slug points without redirecting
delete_shortlinkRemove a shortlink before it expires
shortlink_statusHealth check showing active link count and TTL

All tools are free -- no credits, no npub, no Tollbooth ledger required.

Install

bash
pip install -e ".[dev]"

Run Locally

bash
export NEON_SHORTLINKS_URL="<your Neon connection string>"# optional: the redirect host put in front of each slug (default https://go.tollbooth-dpyc.com)export SHORTLINK_REDIRECT_BASE="https://go.tollbooth-dpyc.com"python -c "from server import mcp; mcp.run()"

The redirect Worker in worker/redirect.js reads the same NEON_SHORTLINKS_URL, set as a Worker secret. A change to it on main deploys it (.github/workflows/deploy-worker.yml, which needs the CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID repo secrets).

Deploy to Horizon

The fastmcp.json 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 by asking the Oracle, and create_shortlink returns the full short_url, so a peer never needs the redirect host:

python
from tollbooth.oracle_client import default_oracle_client
svc = await default_oracle_client().resolve_service(name="tollbooth-shortlinks")shortlinks_url = (svc or {}).get("url", "")

Operators built on tollbooth-dpyc get this for free: tollbooth.shortlinks.create_shortlink(url) does the lookup and the call, best-effort.

Related Repos

The Tollbooth DPYC™ ecosystem:

RepoRole
tollbooth-dpycThe wheel -- operator-side credit ledger, BTCPay client, tool gating, constraint engine
tollbooth-authorityThe institution -- fee collection, Schnorr signing, purchase certification
dpyc-oracleThe oracle -- Social Contract governance, membership, ban elections
dpyc-communityThe registry -- governance data, operator catalog, community rules
tollbooth-sampleReference operator -- weather API with full Tollbooth wiring
cypher-mcpMonetized graph answers -- named Cypher over Neo4j/AuraDB
schwab-mcpCharles Schwab brokerage MCP -- quotes, positions, orders and transaction history (read-only)
excalibur-mcpeXcalibur -- formatted posting to X (Twitter)
thebrain-mcpPersonal Brain MCP -- thought graphs, knowledge management
taxsort-mcpTax sorting and classification MCP
optionality-mcpOptions analytics MCP
goodearth-mcpGood Earth -- region-scoped farm climate analytics
beesknees-mcpThe Bee's Knees -- a monetized multiplayer race to the queen
roastify-mcpRoastify coffee catalog and packaging artwork
ChartRemotely-mcpChartRemotely -- drives a desktop chart through a paired agent
tollbooth-webShared browser SDK for operator front ends
tollbooth-shortlinks (this repo)Community utility -- ephemeral short URLs for OAuth flows
tollbooth-oauth2-collectorOAuth2 callback collector -- browser-based token exchange
tollbooth-pricing-studioiOS app -- operator dashboard and pricing model editor

License

Apache-2.0. See LICENSE for details.

Source: README.md at commit b7fc2d0

Tools

4

Version history

2
  1. v0.2.0LatestOct 21, 2026
  2. v0.1.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts