Log inSubmit server
Caelario logo

Caelario

Extract and automate Instagram, TikTok, YouTube, X, and Facebook data with credit-aware MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Caelario

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "caelario-2": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp@latest"
      ]
    }
  }
}

Settings ā†’ Developer ā†’ Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-testedā€” the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Caelario MCP server connects AI clients to Caelarioā€™s social-media extraction service for Instagram, TikTok, YouTube, X, and Facebook. It exposes tools for platform discovery, credit estimates, immediate extractions, durable jobs, paginated results, batches, and scheduled runs. Use it when an agent needs structured social-media data or repeatable extraction workflows without handling provider credentials directly. The package runs locally over MCP while provider identities and acquisition services remain managed by Caelario.

Use cases

  • Extract a social profile or recent posts for an agent workflow
  • Estimate credit usage before starting a paid extraction
  • Run extraction batches across up to 100 targets
  • Schedule recurring social-media data collection
  • Page through completed extraction results

Key features

  • Instagram, TikTok, YouTube, X, and Facebook extraction
  • Credit balances, limits, guides, and reservation estimates
  • Synchronous and durable extraction jobs
  • Batch processing for up to 100 targets
  • Timezone-aware recurring schedules
  • Paginated result retrieval

Tools21

What Caelario lets your agent do. Expand a tool for its parameters.

Verified live~2.5k tokens of context

Security & health

What it can reach and how reliably it runs ā€” from our own checks, not the maintainerā€™s claims.

ActiveLast checked Today

Recent health check succeeded.

10/10 checks healthy over the last 61d

What it can do

From the 21 tools this server returned when we ran it.

Runs commands Ā· 1Can delete or modify data Ā· 1Makes network requests Ā· 2Read-only tools Ā· 19
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceNot published
Package age66 days
Maintainers1

Observed 2026-10-31 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 4d ago via OSV.dev Ā· caelario-mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks ā€” not a rating.

npm downloads1kPackage downloads in the last 30 days.
Last commit4d agoMost recent push to the default branch.
Tools exposed21Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Caelario works

What Caelario does

Caelario provides MCP access to social-media data workflows covering Instagram, TikTok, YouTube, X, and Facebook. It supports capability discovery, extraction requests, usage tracking, result retrieval, batch processing, and recurring schedules.

The tool set separates short-running work from jobs that may continue in the background. extract_now handles one bounded target synchronously, while durable jobs can be created, monitored, cancelled, and read through separate operations. Completed results can be paged so large responses do not fill the model context.

Credit-aware operations are built into the workflow. Agents can inspect workspace identity and limits, review credit balances, learn an operationā€™s requirements, and estimate the maximum reservation before starting work.

How it works

The local package registers a stdio MCP server with the selected client. Requests are sent to Caelarioā€™s hosted service, which manages provider identities and the underlying acquisition infrastructure. The installer does not request separate Instagram, TikTok, YouTube, X, or Facebook credentials.

For longer work, an agent can create an extraction job and then use listing, status, waiting, cancellation, and result-pagination tools. Batches support up to 100 targets for one operation and expose aggregate status along with child jobs. Schedules can run once, daily, weekly, or monthly, with timezone-aware definitions and controls to pause, resume, run immediately, update, or delete them.

If a request times out, the returned idempotency_key can be reused with identical arguments to recover the original request rather than initiate another paid extraction. The default HTTP timeout is 120 seconds. Failed jobs retain their error information and remain marked as not ready.

Setup and configuration

The guided setup is available at app.caelario.com/connect. Create a Caelario account, choose Codex or Claude Code, and generate a workspace connection key. New accounts start with 200 free credits.

Node.js 20 or newer is required. Install for Codex with:

Terminal
npx -y caelario-mcp@latest install codex

Install for Claude Code with:

Terminal
npx -y caelario-mcp@latest install claude

To configure Claude Desktop explicitly, use:

Terminal
npx -y caelario-mcp@latest install claude-desktop

The installer registers the server at user scope and preserves existing desktop settings and other MCP servers. On first setup, or when a key is rejected, it opens the guided setup and securely prompts for a replacement key in the terminal. Restart the client after installation and approve Caelario when prompted.

Tools and capabilities

  • Discover available platforms, operations, limits, and prices.
  • Validate an operation and estimate credit reservations before extraction.
  • Inspect workspace identity, extraction limits, and credit categories.
  • Run bounded synchronous extractions.
  • Create, list, inspect, wait for, cancel, and paginate durable extraction jobs.
  • Create and manage batches covering up to 100 targets.
  • Create and control timezone-aware recurring extraction schedules.

Limitations and notes

The connector is MIT licensed, but Caelarioā€™s hosted API, provider implementations, acquisition infrastructure, and managed identities are proprietary services outside the package. Extraction work uses credits, including reservations associated with operations. Large job results should be fetched through pagination rather than embedded in job listings or status responses.

The package includes MCP Registry metadata under io.github.chunkydonut21/caelario. npm publication precedes the separate Registry publication step.

Read the full README View source on GitHub

Reviews

No reviews yet ā€” be the first to share how it worked for you.

Frequently Asked Questions about Caelario

Caelario is an MCP server that connects AI clients to social-media data extraction for Instagram, TikTok, YouTube, X, and Facebook. Its main tools discover platforms and operations, estimate credits, run immediate or durable extractions, retrieve paginated results, manage batches, and schedule recurring jobs.

Install it with the npm command for your client: `npx -y caelario-mcp@latest install codex`, `install claude`, or `install claude-desktop`. The installer registers the local stdio server and guides you through creating or entering a Caelario workspace connection key.

Yes, Caelario supports Claude Desktop through `npx -y caelario-mcp@latest install claude-desktop`. After installation, quit and reopen Claude, approve Caelario when requested, and ask the client to check the connection and available credits.

Reuse the `idempotency_key` returned in the tool error with identical arguments. This recovers the original request instead of starting another paid extraction. The default HTTP timeout is 120 seconds.

Use `create_schedule` to define a timezone-aware once, daily, weekly, or monthly extraction. Use the schedule management tools to list, inspect, update, pause, resume, run immediately, or delete schedules.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow itā€™s listed ā€” live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewCaelario AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/caelario-2?style=directory)](https://allmcps.com/mcp/caelario-2)
HTML Embed
<a href="https://allmcps.com/mcp/caelario-2"><img src="https://allmcps.com/api/badge/caelario-2?style=directory" alt="Caelario on AllMCPs" /></a>