Lection
Search YouTube videos, channel uploads and comments as tables; manage Lection schedules.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'lection_browser_tools_info' suggests web access but openWorldHint=falsein lection_browser_tools_info
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"lection-mcp": {
"url": "https://www.lection.app/mcp"
}
}
}Remote endpoints
https://www.lection.app/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢youtube_search(query, maxRows)
Search YouTube for videos by keyword, like "n8n automation tutorial" or "best budget laptops 2026". Returns up to 20 videos with title, channel, view count, upload date, duration and URL. Use it for content research, finding competitors and spotting popular topics. To list videos from one specific channel use youtube_channel_videos instead.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Search keywords, exactly as you would type them into YouTube.",
"type": "string",
"minLength": 2,
"maxLength": 150
},
"maxRows": {
"description": "How many rows to return (1-20, default 20). The free ChatGPT app is capped at 20.",
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"count": {
"description": "Number of rows returned",
"type": "number"
},
"rows": {
"description": "Result rows",
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"fullToolUrl": {
"description": "Lection page for running this at full scale with exports and schedules",
"type": "string"
},
"error": {
"type": "string"
}
},
"required": [
"tool",
"count",
"rows"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢youtube_channel_videos(channel, maxRows)
List the latest videos on one YouTube channel, given its @handle or URL (for example "@OpenAI" or https://www.youtube.com/@OpenAI). Returns up to 20 recent uploads with title, upload date, view count, duration and URL. Use it to audit a creator or competitor channel. To search all of YouTube by keyword use youtube_search.
Input Schema
{
"type": "object",
"properties": {
"channel": {
"description": "Channel @handle (e.g. \"@OpenAI\") or channel URL.",
"type": "string",
"minLength": 2,
"maxLength": 300
},
"maxRows": {
"description": "How many rows to return (1-20, default 20). The free ChatGPT app is capped at 20.",
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"channel"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"count": {
"description": "Number of rows returned",
"type": "number"
},
"rows": {
"description": "Result rows",
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"fullToolUrl": {
"description": "Lection page for running this at full scale with exports and schedules",
"type": "string"
},
"error": {
"type": "string"
}
},
"required": [
"tool",
"count",
"rows"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢youtube_comments(url, maxRows)
Fetch top-level comments from one public YouTube video, given its URL. Returns up to 20 top comments with author, text, like count, reply count, date and the author's channel link. Use it for audience sentiment, feedback mining and finding engaged commenters. Needs a specific video URL; to find videos first use youtube_search.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Full YouTube video URL, e.g. https://www.youtube.com/watch?v=dQw4w9WgXcQ (youtu.be and /shorts/ links also work).",
"type": "string",
"minLength": 5,
"maxLength": 300
},
"maxRows": {
"description": "How many rows to return (1-20, default 20). The free ChatGPT app is capped at 20.",
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output Schema
{
"type": "object",
"properties": {
"tool": {
"type": "string"
},
"count": {
"description": "Number of rows returned",
"type": "number"
},
"rows": {
"description": "Result rows",
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"fullToolUrl": {
"description": "Lection page for running this at full scale with exports and schedules",
"type": "string"
},
"error": {
"type": "string"
}
},
"required": [
"tool",
"count",
"rows"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢lection_browser_tools_info(platform)
Explain how to export data from Instagram (comments, followers, following, posts) or LinkedIn (connections) with Lection. These sites require login, so they run in the user's own browser through the Lection Chrome extension rather than inside ChatGPT. Call this whenever the user asks for Instagram or LinkedIn data; it returns the install link and the right tool page.
Input Schema
{
"type": "object",
"properties": {
"platform": {
"description": "Which site the user wants data from.",
"type": "string",
"enum": [
"instagram",
"linkedin",
"other"
]
}
},
"required": [
"platform"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢my_lection_account
Show the linked user's Lection plan, how many schedules they can run, allowed delivery destinations and available cloud credits. Use before scheduling or when a plan limit is hit.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_my_saved_scrapes(limit)
List the user's most recent saved scrapes in Lection (title, page, row count, id). A saved scrape is the starting point for schedule_extraction and get_run_results.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "How many recent saved scrapes to list (1-20).",
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_run_results(id, kind, maxRows)
Fetch the rows of one of the user's saved scrapes or scheduled runs by id and show them as a table. Use list_my_saved_scrapes or list_my_runs first to find the id.
Input Schema
{
"type": "object",
"properties": {
"id": {
"description": "Id of a saved scrape (from list_my_saved_scrapes) or of a scheduled run (from list_my_runs).",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"kind": {
"description": "Whether `id` is a saved scrape or a scheduled run.",
"type": "string",
"enum": [
"saved_scrape",
"scheduled_run"
]
},
"maxRows": {
"description": "Rows to return (1-200).",
"default": 50,
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"required": [
"id",
"kind"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_my_schedules(status, limit)
List the user's scheduled extractions: name, cadence, destination, next run and last status.
Input Schema
{
"type": "object",
"properties": {
"status": {
"description": "Filter by schedule status.",
"type": "string",
"enum": [
"active",
"paused"
]
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_my_runs(scheduleId, status, limit)
List recent runs of the user's schedules with status, row counts and errors.
Input Schema
{
"type": "object",
"properties": {
"scheduleId": {
"description": "Only runs of this schedule.",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"status": {
"type": "string",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"cancelled",
"timed_out"
]
},
"limit": {
"default": 10,
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴schedule_extraction(savedScrapeId, name, cadence, timeOfDay, weekday, ...)
Create a recurring schedule (hourly, daily or weekly) that re-runs one of the user's saved scrapes and delivers each run to email, a Google Sheet or a webhook. This creates a recurring job in the user's Lection account and may use cloud credits: confirm the saved scrape, cadence and destination with the user before calling. Respects the user's plan limits and returns a clear message if one is reached.
Input Schema
{
"type": "object",
"properties": {
"savedScrapeId": {
"description": "Id of an existing saved scrape in the user's Lection account (from list_my_saved_scrapes). The schedule re-runs that scrape.",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"name": {
"description": "Schedule name, at least 3 characters.",
"type": "string",
"minLength": 3,
"maxLength": 80
},
"cadence": {
"description": "How often to run.",
"type": "string",
"enum": [
"hourly",
"daily",
"weekly"
]
},
"timeOfDay": {
"description": "HH:MM (24h) in the given timezone, for daily/weekly. Default 09:00.",
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$"
},
"weekday": {
"description": "0=Sunday .. 6=Saturday, for weekly. Default 1 (Monday).",
"type": "integer",
"minimum": 0,
"maximum": 6
},
"timezone": {
"description": "IANA timezone, e.g. \"America/Chicago\". Default UTC.",
"type": "string",
"maxLength": 64
},
"destination": {
"description": "Where each run is delivered. google_sheet needs the user to have connected Google Sheets in Lection; webhook needs webhookUrl.",
"default": "email",
"type": "string",
"enum": [
"email",
"google_sheet",
"webhook"
]
},
"spreadsheetUrl": {
"description": "Google Sheet URL (destination google_sheet).",
"type": "string",
"format": "uri"
},
"webhookUrl": {
"description": "HTTPS webhook URL (destination webhook).",
"type": "string",
"format": "uri"
}
},
"required": [
"savedScrapeId",
"name",
"cadence"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴pause_schedule(scheduleId)
Pause one of the user's schedules so it stops running. The user can resume it from the Lection dashboard. Confirm with the user first.
Input Schema
{
"type": "object",
"properties": {
"scheduleId": {
"description": "Id of the schedule to pause (from list_my_schedules).",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"required": [
"scheduleId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence