Connecting AI Assistants (MCP)
Connect Claude and other MCP clients to Shorty over OAuth 2.1 to summarize, transcribe, and search your content.
Shorty runs a remote MCP (Model Context Protocol) server, so AI assistants like Claude Code and Claude.ai custom connectors can use Shorty on your behalf. The product page is aishorty.com/mcp.
Endpoint
https://aishorty.com/api/mcpThe server speaks streamable HTTP and authenticates exclusively via OAuth 2.1 with PKCE. Clients register automatically (unauthenticated Dynamic Client Registration), you sign in with your normal Shorty account, and a consent screen shows exactly which scopes the assistant is requesting before anything is granted. API keys and session cookies are deliberately rejected on this endpoint — only user-consented OAuth grants get tools.
Quick connect (Claude Code)
claude mcp add --transport http shorty https://aishorty.com/api/mcpYour browser opens for sign-in and consent on first use. In Claude.ai, add Shorty as a custom connector with the same endpoint URL.
Available tools
Tools are scope-filtered: a tool only appears to the assistant if you granted its scope on the consent screen.
| Tool | Scope | What it does |
|---|---|---|
create_youtube_summary | articles:write | Summarize a YouTube video |
create_content_summary | articles:write | Summarize a web page or content |
create_transcription | transcriptions:write | Start a transcription job |
create_subtitles | transcriptions:write | Start a subtitle-generation job |
get_job_status | jobs:read | Poll a job you started |
list_recent_articles | articles:read | List your saved summaries |
search_articles | articles:read | Search your articles |
get_article | articles:read | Fetch one article |
list_transcriptions | transcriptions:read | List your transcriptions |
get_transcription | transcriptions:read | Fetch one transcription |
get_usage_quota | usage:read | Read your plan, quotas, and usage |
search_docs | docs:read | Search Shorty's developer docs |
Write tools are quota-gated compute jobs (they respect the same plan quotas as the web app and API) and support an optional idempotency key so retries never create duplicate jobs. There are no destructive tools — nothing can publish, delete, or change account settings.
Managing connected apps
You can review and revoke any connected AI app from your Shorty account settings. Revoking removes the consent and invalidates the app's tokens.
Free-tier agent usage is metered: 10 summaries per day and 3 transcriptions per month across API keys and MCP. Paid plans are not capped on these counts. Using the Shorty website directly is never limited by these agent quotas.