Tollbooth Shortlinks

Don't Pester Your Customer™ (DPYC™) — URLs cortas efímeras y amigables para humanos para el ecosistema Tollbooth.

Las metáforas de este proyecto están tomadas con admiración de The Phantom Tollbooth de Norton Juster, ilustrado por Jules Feiffer (1961). Milo, Tock, el Tollbooth, Dictionopolis y Digitopolis son creaciones de la extraordinaria imaginación del Sr. Juster. Nosotros solo construimos la infraestructura de pagos.

Por qué existe esto

Las URL de autorización OAuth son largas, feas y hostiles para copiar y pegar:

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=...

Los acortadores de enlaces tradicionales se han vuelto dogmáticos. Inyectan páginas intermedias, rastrean clics, requieren cuentas, bloquean funciones detrás de muros de pago o expiran enlaces silenciosamente según su propio calendario. Cuando un servidor MCP necesita entregar a un cliente una URL de un solo uso para un baile OAuth, nada de eso pertenece al camino.

Tollbooth Shortlinks es una utilidad comunitaria sin monetización. Convierte cualquier URL en una frase memorable de cuatro palabras como brave-otter-finds-gold, almacena el mapeo en Neon Postgres y lo expira después de 24 horas. Un manejador HTTP complementario de Val Town hace la redirección 302 sin ninguna página intermedia.

Related MCP server: mcp-server-hotw

Cómo funciona

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   |

Herramientas

Todas las herramientas son gratuitas -- sin créditos, sin npub, sin necesidad de libro mayor de Tollbooth.

Instalación

pip install -e ".[dev]"

Ejecutar localmente

export NEON_SHORTLINKS_URL="postgres://user:pass@ep-xyz.us-east-2.aws.neon.tech/shortlinks"
python -c "from server import mcp; mcp.run()"

Desplegar en Horizon

El archivo .fastmcp.yaml en la raíz del repositorio está listo para fastmcp deploy.

Identidad DPYC

Tollbooth Shortlinks está registrado como Advocate en el Contrato Social DPYC. Los servidores MCP pares descubren su URL mediante la búsqueda en el registro:

from tollbooth import resolve_service_by_name

shortlinks_url = resolve_service_by_name("tollbooth-shortlinks")
redirect_base  = resolve_service_by_name("tollbooth-shortlinks-redirect")

Repos relacionados

El ecosistema Tollbooth DPYC™:

Licencia

Apache-2.0. Consulta LICENSE para más detalles.