[Integration]: URL Shortener Tool — Free URL shortening via TinyURL (no API key required)

[nikhilvarmakandula]

Service

TinyURL — free URL shortening API. No signup, no API key, no cost.
API docs: https://tinyurl.com/app/dev

Reason

Agents handling content sharing, notifications, emails, or social media workflows
need to shorten long URLs. TinyURL is completely free with no auth barrier and
allows commercial use.

Credential Identity

• credential_id: N/A (no authentication required)
• env_var: None needed

Tools

• url_shorten — shorten any long URL into a compact TinyURL link
• url_shorten_custom — shorten a URL with a custom alias

Auth Methods

• Direct API key supported: No (not needed)
• Aden OAuth supported: No (not needed)

Health Check

• Endpoint: https://tinyurl.com/api-create.php?url=https://example.com
• Method: GET
• 200 = API is working

Additional Context

• Completely free, no rate limit issues for normal usage
• Commercial use allowed
• No signup required
• Parent issue: [Integration]: Expand agent capabilities by adding more integrations/tools #2805

Implementation

I will implement this following existing tool patterns (time_tool).
Ready to submit PR immediately after assignment.

[nikhilvarmakandula]

@TimothyZhang7 @RichardTang-Aden I'd like to be assigned to implement this. I have the Hive environment set up locally on Windows/WSL and am ready to start immediately.

[SpawnDev]

Very nice idea for a tool, I dig this.

[nikhilvarmakandula]

@Hundao @TimothyZhang7 just wanted to follow up — happy to start immediately once assigned!

[Hundao]

Hey @nikhilvarmakandula, can you share a specific use case where an agent would need to shorten URLs mid-task? Trying to understand when this tool would actually get called during an agent run.

[nikhilvarmakandula]

@Hundao Sure! Here are a few concrete use cases:

1. Email/notification agents — An agent that drafts and sends emails with long tracking URLs or report links needs to shorten them before inserting into the email body for cleaner formatting.

2. Social media agents — An agent posting to Twitter/X has a 280-character limit. If it needs to share a link to a report, dashboard, or article, shortening the URL mid-task is essential to fit within the limit.

3. CRM/outreach agents — An agent generating personalized outreach messages (e.g., via HubSpot or Brevo) can shorten URLs to make messages look cleaner and more professional before sending.

4. Report delivery agents — An agent that generates a report URL (e.g., a long S3 presigned URL or Google Docs link) and needs to share it via Slack or Telegram would shorten it for readability.

The common pattern is: agent generates or retrieves a long URL → needs to share it in a space-constrained or presentation context → shortens it before sending.

[nikhilvarmakandula]

@Hundao @TimothyZhang7 just wanted to follow up , happy to make changes if needed

[Hundao]

Hi @nikhilvarmakandula, the idea makes sense but tying it to TinyURL specifically is too fragile. We'd want something more like how our email tool works (tools/src/aden_tools/tools/email_tool/): one url_shorten tool that supports multiple providers (TinyURL, Bitly, Short.io, etc.), where the user picks their provider via credentials config.

Would you be interested in taking that approach instead?

[yusuf-levent]

Hi! I’d like to work on this TinyURL integration.

I have experience building a URL shortener backend, so this tool is a good fit for me. I can implement the MVP with:

• url_shorten
• url_shorten_custom
• input validation
• mocked unit tests for success and error cases
• README with setup and usage examples

I’ll follow the existing tool patterns and reference parent issue #2805. Could I get assigned to this issue?

[suvijya]

I'd like to work on this! I'll implement the URL Shortener tool using TinyURL's free API (no key required), following the existing tool patterns. Ready to submit PR once assigned.