Skip to main content
Use drdj-shortener when an agent only needs to create a drdj.me short link, upload a photo short link, or read owned short-link stats. Use the full DealDash Agent Bridge only when the task also needs deals, contacts, payments, LinkShot view checks, templates, tasks, screenshots beyond photo links, memory, or approvals.

​
Fast HTTPS Path

GET https://drdj.me/api/shortener/v1/health

POST https://drdj.me/api/shortener/v1/links
Content-Type: application/json

{
  "url": "https://example.com/campaign",
  "title": "Optional title"
}
Return only shortUrl and shortId unless the user asks for metadata.

​
MCP Server

Repo-local config:
  • /plugins/drdj-shortener/.mcp.json
Server command: 
pnpm exec tsx ./plugins/drdj-shortener/scripts/server.ts
Tools:
  • shorten_link
  • upload_photo_link
  • get_link_stats
  • store_access_token
Environment:
  • DRDJ_SHORTENER_BASE_URL
  • DRDJ_SHORTENER_ACCESS_TOKEN
  • DRDJ_SHORTENER_CHANNEL
  • DRDJ_SHORTENER_ACTOR_ID

​
Access Modes

Guest mode is URL-only, rate-limited, temporary, and does not create private dashboard ownership. Registered agent mode uses shortener-scoped OAuth and enables custom slugs, campaigns, tags, descriptions, photo links, private stats, settings reads, and DealDash dashboard visibility after approval. Broad DealDash bridge scopes such as mcp or dealdash.read do not authorize standalone shortener tools. Default shortener scopes: 
shortener.links:create shortener.links:read shortener.stats:read shortener.photos:create shortener.settings:read
Public-safe stats are available only for guest/public links. Registered-agent links require get_link_stats or GET /api/shortener/v1/links/:shortId/stats with an approved owner token.

​
Agent Prompt

Create a drdj.me short link for [paste URL]. Use HTTPS or the drdj-shortener skill. Return only the short link.

​
Deployment Notes

Production has the shortener database migration applied. For any new environment, apply /migrations/extend-shortener-for-ai-agents.sql before real /api/shortener/v1/* traffic is enabled. Public discovery is available after deployment at:
  • /.well-known/agent-skills/index.json
  • /.well-known/agent-skills/drdj-shortener/SKILL.md
  • /.well-known/mcp/drdj-shortener/server-card.json
  • /openapi.json
  • /api/shortener/v1/health