{"id":"tinyurl-mcp-server","name":"tinyurl-mcp-server","homepage":"https://pypi.org/project/tinyurl-mcp-server/","repo_url":"https://github.com/1001coder/tinyurl-mcp-server","category":"api-gateway","subcategories":[],"tags":["mcp","url-shortener","tinyurl","tooling","python","api-integration"],"what_it_does":"Provides an MCP server that creates TinyURL short links using the TinyURL API, configured via an API key in environment variables.","use_cases":["Generate TinyURL short links from longer URLs via an MCP-enabled agent workflow.","Integrate URL shortening into chat/agent automation using a tool-style interface."],"not_for":["Bulk URL shortening at high volume without clear rate-limit/error-handling guarantees.","Production systems that require strong reliability guarantees or documented operational behavior (SLA, retries, idempotency) beyond minimal documentation."],"best_when":"You want a lightweight MCP tool to shorten URLs with TinyURL and can supply the TinyURL API key securely.","avoid_when":"You need documented MCP tool schemas, pagination behavior (if any), strict rate-limit handling, or strong guarantees around retries/idempotency and error recovery.","alternatives":["Use TinyURL directly via its REST API (e.g., HTTP client calls with an API key).","Use other URL shorteners with better-documented APIs/SDKs (e.g., Bitly-style providers) or a self-hosted shortener (e.g., YOURLS) depending on requirements.","Implement an internal MCP server/tool for URL shortening tailored to your operational needs."],"af_score":39.2,"security_score":52.0,"reliability_score":22.5,"package_type":"mcp_server","discovery_source":["pypi"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T21:41:48.451517+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Environment variable API key: TINYURL_API_KEY (implied by README configuration)."],"oauth":false,"scopes":false,"notes":"Authentication appears to be via a single TinyURL API key passed as an environment variable. No OAuth or scope model is described in the provided materials."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information is included in the provided repository materials; TinyURL API costs (if any) are not described here."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":39.2,"security_score":52.0,"reliability_score":22.5,"mcp_server_quality":45.0,"documentation_accuracy":35.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":85.0,"rate_limit_clarity":10.0,"tls_enforcement":60.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":55.0,"secret_handling":70.0,"security_notes":"TLS enforcement to the TinyURL API is not evidenced in provided materials (likely HTTPS via requests, but not confirmed). Authentication appears to use an API key (reasonable strength) without described scoping. Secret handling is implied via environment variable configuration, but there is no explicit statement about logging/redaction. Dependency hygiene is unknown beyond declared deps (mcp, requests).","uptime_documented":0.0,"version_stability":40.0,"breaking_changes_history":30.0,"error_recovery":20.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["README only shows high-level MCP config; tool names/inputs/outputs and error formats are not documented in the provided materials, so agents may need to experiment to discover the exact MCP interface contract.","No guidance is given for rate limits, retries, or idempotency; agents may create duplicate short links if they retry without an idempotency strategy.","Secure handling of TINYURL_API_KEY is required; example config shows env var usage but does not state how the MCP server logs/errors are handled."]}}