# Caelario

> Caelario is a paid MCP server for web search and scraping. Instagram, TikTok, YouTube, X and Facebook data pulls from Codex or Claude, paid by credit. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://caelario.com/mcp-server
- **Repository:** https://github.com/chunkydonut21/caelario-mcp
- **MCP Registry name:** io.github.chunkydonut21/caelario
- **Categories:** web search and scraping, marketing and SEO
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/caelario
