Skip to content
MCP server

Caelario

Instagram, TikTok, YouTube, X and Facebook data pulls from Codex or Claude, paid by credit

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
CLI, API
Runs
Locally
Version
0.1.9
Listing updated
3 days ago

About Caelario

Caelario is a paid MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

The agent never gets social network logins. It talks to a Caelario workspace through a local stdio package, and the package sends your Caelario connection key only to the Caelario API. From a conversation you can check credits, look up what each platform supports, estimate the maximum credit reservation for a job, then run it.

Small requests can run synchronously and return a page of structured results in the chat. Larger work becomes a durable job or multi-target batch with an ID, which can be waited on, cancelled and paged through so a big dataset does not flood the context window. Schedules repeat a collection once, daily, weekly or monthly, with history kept in the same workspace. If a request times out, the idempotency key in the error lets you recover the original request instead of paying for a second extraction.

The local connector is MIT-licensed, while the hosted API and acquisition infrastructure are proprietary services. The README requires Node.js 20 or newer. One installer command handles Codex, Claude Code and Claude desktop.

Install

Run in a terminal

claude mcp add caelario --env CAELARIO_API_KEY='<CAELARIO_API_KEY>' -- npx -y caelario-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "caelario": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ],
      "env": {
        "CAELARIO_API_KEY": "<CAELARIO_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "caelario": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ],
      "env": {
        "CAELARIO_API_KEY": "<CAELARIO_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "caelario": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ],
      "env": {
        "CAELARIO_API_KEY": "<CAELARIO_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "caelario": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ],
      "env": {
        "CAELARIO_API_KEY": "<CAELARIO_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "caelario": {
      "command": "npx",
      "args": [
        "-y",
        "caelario-mcp"
      ],
      "env": {
        "CAELARIO_API_KEY": "<CAELARIO_API_KEY>"
      }
    }
  }
}

Configuration

  • CAELARIO_API_KEYGet your Caelario account and connection key at https://app.caelario.com/connect. The browser setup guides you through registration and connection.Required

What it does

Cost estimates first
Shows limits and maximum credit reservation before a collection starts.
Inline or durable runs
Bounded targets answer in chat; larger work becomes jobs and batches with IDs.
Paged results
Large datasets are returned in pages to protect the context window.
Recurring schedules
Create once, daily, weekly or monthly collections with history.
Safe retries
An idempotency key recovers a timed-out request without a second paid extraction.
One-command install
npx caelario-mcp install handles Codex, Claude Code and Claude desktop.

Good for

  • Pull a brand's Instagram profile and recent posts
  • Schedule a weekly collection of competitor content
  • Fetch YouTube transcripts for research
  • Run batch extraction across several TikTok or X targets
  • Check remaining credits before a large job

Pricing

Paid

Credits from $1.90 per 1,000 (Launch), $1.56 (Scale), $1.32 (Volume); 200 promotional credits for new workspaces

Prices change. Check caelario.com before you buy.

Caelario FAQ

Do I give the agent my social media passwords?

No. The README says it does not ask for Instagram, TikTok, YouTube, X or Facebook credentials.

How is it priced?

Credits are bought in bundles from $1.90 per 1,000 credits, they do not expire, and there is no recurring charge. New workspaces get 200 promotional credits valid for 30 days.

Does it work in web-only chats?

No. The package is a local connection and does not enable a connector in web-only chats or cloud sessions.

What does it need?

Node.js 20 or newer and a Caelario connection key.

Is Caelario free?

No. Caelario is a paid product.

How do I add Caelario to Claude Code?

Run this command in your terminal: claude mcp add caelario --env CAELARIO_API_KEY='<CAELARIO_API_KEY>' -- npx -y caelario-mcp

What are the best alternatives to Caelario?

The closest alternatives to Caelario are Scrapling MCP Server, Firecrawl MCP Server, Google Ads + Meta Ads + SEO/GEO MCP, SearXNG Search and Calven.

Alternatives to Caelario

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  5. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  6. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping