Post Reef
Turn YouTube, TikTok, Instagram, Facebook, X and article URLs into transcripts, comments and JSON.
Should I use this
Quality & Safety
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": {
"postreef": {
"url": "https://postreef.com/mcp"
}
}
}Remote endpoints
https://postreef.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (6)
🟢quote(url, parts, inputs, schemaId, schema)
Use this before extract to see what a link is (title, duration, whether it has subtitles and comments) and exactly how many credits the extraction would cost with the same parameters. Nothing is charged and nothing is started.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "Public link to one video, post or web page (YouTube, Shorts, TikTok, Instagram, Facebook, X, Vimeo, an article, …)."
},
"parts": {
"description": "Download-only runs (no schema): which artifacts to fetch. Any of transcript, comments, audio, video. Omit for all of them. Metadata, thumbnail and description always come back.",
"type": "array",
"items": {
"type": "string",
"enum": [
"transcript",
"comments",
"audio",
"video"
]
}
},
"inputs": {
"description": "AI runs (with schemaId or schema): what the model reads. Any of transcript, comments, audio, video. Default transcript + comments. Do not combine with parts.",
"type": "array",
"items": {
"type": "string",
"enum": [
"transcript",
"comments",
"audio",
"video"
]
}
},
"schemaId": {
"description": "Turn the content into JSON with a saved schema: a predefined one by name (Recipe, Workout, Product review, …) or id, or one of the user's own schema ids. See list_schemas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"schema": {
"description": "Inline JSON Schema (top-level object) for the extracted JSON, instead of schemaId. No type unions; enums of strings only; optional fields are simply left out of required.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
}
},
"required": [
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "quote"
},
"url": {
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"durationSec": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"hasSubtitles": {
"type": "boolean"
},
"hasComments": {
"type": "boolean"
},
"mode": {
"type": "string",
"enum": [
"ai",
"download"
]
},
"credits": {
"type": "number"
},
"fetches": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"kind",
"url",
"title",
"durationSec",
"hasSubtitles",
"hasComments",
"mode",
"credits",
"fetches"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟡extract(url, parts, inputs, schemaId, schema, ...)
Use this when the user wants the transcript, comments, metadata, video/audio files or structured JSON from a video, post or web page. Starts an extraction on the user's Post Reef account (debits its credits; refunded if it fails) and waits up to wait_seconds for the result. Pass schemaId or schema for JSON, otherwise it is a download. Call quote first if the user wants to know the cost.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"minLength": 1,
"maxLength": 2048,
"description": "Public link to one video, post or web page (YouTube, Shorts, TikTok, Instagram, Facebook, X, Vimeo, an article, …)."
},
"parts": {
"description": "Download-only runs (no schema): which artifacts to fetch. Any of transcript, comments, audio, video. Omit for all of them. Metadata, thumbnail and description always come back.",
"type": "array",
"items": {
"type": "string",
"enum": [
"transcript",
"comments",
"audio",
"video"
]
}
},
"inputs": {
"description": "AI runs (with schemaId or schema): what the model reads. Any of transcript, comments, audio, video. Default transcript + comments. Do not combine with parts.",
"type": "array",
"items": {
"type": "string",
"enum": [
"transcript",
"comments",
"audio",
"video"
]
}
},
"schemaId": {
"description": "Turn the content into JSON with a saved schema: a predefined one by name (Recipe, Workout, Product review, …) or id, or one of the user's own schema ids. See list_schemas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"schema": {
"description": "Inline JSON Schema (top-level object) for the extracted JSON, instead of schemaId. No type unions; enums of strings only; optional fields are simply left out of required.",
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
},
"maxComments": {
"description": "Cap on how many comments to fetch (1-1000, default 1000).",
"type": "integer",
"minimum": 1,
"maximum": 1000
},
"force": {
"description": "Run fresh even if an identical extraction from the last 30 days could be reused for free.",
"type": "boolean"
},
"wait_seconds": {
"description": "How long to wait for the result before returning (0-50, default 45). If it is not done by then, call get_extraction.",
"type": "integer",
"minimum": 0,
"maximum": 50
}
},
"required": [
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "extraction"
},
"note": {
"type": "string"
},
"extraction": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"queued",
"processing",
"complete",
"failed"
]
},
"createdAt": {
"type": "string"
},
"completedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"creditsDebited": {
"type": "number"
},
"cached": {
"type": "boolean"
},
"pageUrl": {
"type": "string"
},
"error": {
"type": "string"
},
"outcome": {
"anyOf": [
{
"type": "string",
"enum": [
"ok",
"no_match",
"uncertain"
]
},
{
"type": "null"
}
]
},
"verdictReason": {
"type": "string"
},
"metadata": {
"type": "object",
"properties": {
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"uploader": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"durationSeconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"uploadDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"viewCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"likeCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"commentCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"title",
"uploader",
"durationSeconds",
"uploadDate",
"viewCount",
"likeCount",
"commentCount",
"description"
],
"additionalProperties": false
},
"transcript": {
"anyOf": [
{
"type": "object",
"properties": {
"text": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"totalChars": {
"type": "number"
}
},
"required": [
"text",
"truncated",
"totalChars"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"comments": {
"anyOf": [
{
"type": "object",
"properties": {
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"author": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"text": {
"type": "string"
},
"likes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"author",
"text",
"likes"
],
"additionalProperties": false
}
}
},
"required": [
"returned",
"total",
"items"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"extraction": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"artifacts": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"url",
"status",
"createdAt",
"completedAt",
"creditsDebited",
"cached",
"pageUrl"
],
"additionalProperties": false
}
},
"required": [
"kind",
"extraction"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_extraction(id, wait_seconds, transcript_max_chars, comments_max)
Use this to check on or read an extraction by id: its status, and once complete the metadata, transcript, comments, extracted JSON and links to every file.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "The extraction id returned by extract or list_extractions."
},
"wait_seconds": {
"description": "Wait up to this long for a running extraction to finish (0-50, default 0).",
"type": "integer",
"minimum": 0,
"maximum": 50
},
"transcript_max_chars": {
"description": "How much of the transcript to return (default 20000 characters).",
"type": "integer",
"minimum": 0,
"maximum": 200000
},
"comments_max": {
"description": "How many comments to return (default 30).",
"type": "integer",
"minimum": 0,
"maximum": 1000
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "extraction"
},
"note": {
"type": "string"
},
"extraction": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"queued",
"processing",
"complete",
"failed"
]
},
"createdAt": {
"type": "string"
},
"completedAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"creditsDebited": {
"type": "number"
},
"cached": {
"type": "boolean"
},
"pageUrl": {
"type": "string"
},
"error": {
"type": "string"
},
"outcome": {
"anyOf": [
{
"type": "string",
"enum": [
"ok",
"no_match",
"uncertain"
]
},
{
"type": "null"
}
]
},
"verdictReason": {
"type": "string"
},
"metadata": {
"type": "object",
"properties": {
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"uploader": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"durationSeconds": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"uploadDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"viewCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"likeCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"commentCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"title",
"uploader",
"durationSeconds",
"uploadDate",
"viewCount",
"likeCount",
"commentCount",
"description"
],
"additionalProperties": false
},
"transcript": {
"anyOf": [
{
"type": "object",
"properties": {
"text": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"totalChars": {
"type": "number"
}
},
"required": [
"text",
"truncated",
"totalChars"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"comments": {
"anyOf": [
{
"type": "object",
"properties": {
"returned": {
"type": "number"
},
"total": {
"type": "number"
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"author": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"text": {
"type": "string"
},
"likes": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"author",
"text",
"likes"
],
"additionalProperties": false
}
}
},
"required": [
"returned",
"total",
"items"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"extraction": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"artifacts": {
"anyOf": [
{
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"url",
"status",
"createdAt",
"completedAt",
"creditsDebited",
"cached",
"pageUrl"
],
"additionalProperties": false
}
},
"required": [
"kind",
"extraction"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_extractions(limit)
Use this to find the user's previous extractions, newest first, with their ids for get_extraction.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "How many recent extractions to list (1-25, default 10).",
"type": "integer",
"minimum": 1,
"maximum": 25
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "list"
},
"extractions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string",
"enum": [
"queued",
"processing",
"complete",
"failed"
]
},
"createdAt": {
"type": "string"
},
"creditsDebited": {
"type": "number"
},
"cached": {
"type": "boolean"
},
"pageUrl": {
"type": "string"
},
"error": {
"type": "string"
}
},
"required": [
"id",
"url",
"title",
"status",
"createdAt",
"creditsDebited",
"cached",
"pageUrl"
],
"additionalProperties": false
}
}
},
"required": [
"kind",
"extractions"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢list_schemas(schemaId)
Use this to see which schemas can turn content into JSON: the predefined ones (Recipe, Workout, Product review, …) and the user's own. Pass schemaId to get one schema's full definition.
Input Schema
{
"type": "object",
"properties": {
"schemaId": {
"description": "Also return the full JSON Schema definition of this schema (name or id).",
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "schemas"
},
"predefined": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"own": {
"type": "boolean"
}
},
"required": [
"id",
"name",
"description",
"fields",
"own"
],
"additionalProperties": false
}
},
"mine": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"fields": {
"type": "array",
"items": {
"type": "string"
}
},
"own": {
"type": "boolean"
}
},
"required": [
"id",
"name",
"description",
"fields",
"own"
],
"additionalProperties": false
}
},
"definition": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
}
},
"required": [
"kind",
"predefined",
"mine"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_profile
Use this to see which Post Reef account is connected and its credit balance.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "profile"
},
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"email": {
"type": "string"
},
"credits": {
"type": "object",
"properties": {
"balance": {
"type": "number"
},
"downloadOnly": {
"type": "number"
}
},
"required": [
"balance",
"downloadOnly"
],
"additionalProperties": false
}
},
"required": [
"kind",
"id",
"name",
"email",
"credits"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence