VidNotes for Agents

Keys are scoped to your VidNotes account. Create one in Settings → Developer platform. Use the same key in the MCP authorization header or in direct API calls.

Authorization: Bearer vnp_...

The secret (vnp_…) is shown once. Each key has its own daily request limit; revoke or permanently remove keys any time from Settings.

Point any MCP client that supports remote Streamable HTTP and custom headers at the hosted server. Client wrappers vary, but the connection fields stay the same:

{
  "type": "http",
  "url": "https://mcp.vidnotes.app/mcp",
  "headers": {
    "Authorization": "Bearer vnp_..."
  }
}

Thirty-six tools return structured JSON across video analysis, saved knowledge, meetings, and playlists:

vidnotes_summarize_video     vidnotes_get_transcript      vidnotes_get_chapters
vidnotes_get_study_guide     vidnotes_get_faq             vidnotes_get_glossary
vidnotes_get_quotes          vidnotes_find_moments        vidnotes_get_timeline
vidnotes_get_notes           vidnotes_get_action_items    vidnotes_get_flashcards
vidnotes_get_quizzes         vidnotes_ask_video           vidnotes_compare_videos
vidnotes_create_note         vidnotes_search_notes        vidnotes_get_note
vidnotes_list_meetings       vidnotes_search_meetings     vidnotes_get_meeting_digest
vidnotes_list_moments        vidnotes_save_moment         vidnotes_delete_moment
vidnotes_get_job             vidnotes_list_playlist       vidnotes_start_playlist_transcription
vidnotes_get_playlist_job    vidnotes_get_playlist_job_items
vidnotes_cancel_playlist_job vidnotes_retry_playlist_job  vidnotes_get_usage
vidnotes_doctor              vidnotes_create_api_key      vidnotes_list_api_keys
vidnotes_revoke_api_key

For long videos, pass asyncJob: true and poll with vidnotes_get_job instead of holding a long request open.

One /v1 contract behind the hosted MCP server. Authenticate with a bearer token; base URL https://api.vidnotes.app.

curl https://api.vidnotes.app/v1/videos/analyze \
  -H "Authorization: Bearer vnp_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://youtube.com/watch?v=...",
    "features": ["transcript", "summary", "chapters"]
  }'

Core endpoints:

POST   /v1/videos/analyze          transcript · summary · chapters · study guide ·
                                   FAQ · glossary · timeline · notes · actions ·
                                   flashcards · quizzes
POST   /v1/videos/ask              ask a question against any video
POST   /v1/videos/compare          shared topics, overlaps, unique angles
GET    /v1/jobs/:jobId             poll a queued async analysis
POST   /v1/notes                   analyze and save
GET    /v1/notes?query=&limit=     search saved notes
GET    /v1/platform/usage          remaining daily quota (does not count)
POST   /v1/platform/api-keys       create · list · revoke keys

Supported sources: public YouTube URLs, existing VidNotes project ids, and raw transcript text.

Out of scope for this release: local video upload through the analyze endpoint, rendered clips, social publishing, and thumbnail generation. The platform is video understanding — not video production.

Each key is rate-limited per day. Check remaining quota any time with vidnotes_get_usage or GET /v1/platform/usage; usage reads never count against the limit.