Connecting AI Assistants (MCP)
Connect Claude and other MCP clients to Shorty over OAuth 2.1 to summarize, transcribe, and search your content.
Connect Shorty to Claude, ChatGPT, or any other AI assistant — it can then search your summaries and create new ones for you, right inside the chat. Shorty runs a remote MCP (Model Context Protocol) server, so assistants like Claude Code and Claude.ai custom connectors can use Shorty on your behalf. You sign in to Shorty once and approve exactly what the assistant may do, and you can cut it off again at any time.
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.
Scopes
Each tool needs a single delegated scope. The consent screen shows exactly which of these an app is asking for, and you grant them one by one.
| Scope | What it grants |
|---|---|
articles:read | Read your saved summaries and articles |
transcriptions:read | Read your transcriptions and their results |
usage:read | Read your plan, quotas, and usage |
articles:write | Create new summaries from YouTube, web pages, or files |
transcriptions:write | Start new transcriptions and subtitle jobs |
jobs:read | Read the status of jobs you have started |
docs:read | Search and read Shorty's developer documentation |
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
Open Settings → Connected AI Apps to review every assistant you have connected, and revoke any of them to cut off its access instantly. Revoking removes both the consent and the app's issued tokens, so the app must ask for your approval again to reconnect.
Connecting an MCP client is subject to Shorty's privacy policy and terms of service.
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.
Get job status GET
Returns the status of an async job the authenticated account started (a summary, transcription, or subtitle job created via a POST here).
For AI agents
How AI assistants and agents connect to Shorty: the remote MCP server, machine-readable llms.txt / llms-full.txt, Markdown twins of every docs page, the OpenAPI spec, and agent interaction guidelines.