> ## Documentation Index
> Fetch the complete documentation index at: https://juicer.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Let AI agents drive the Juicer API over the Model Context Protocol (MCP). Manage feeds, sources, posts, and analytics in natural language.

The Juicer **MCP Server** lets AI agents drive the Juicer API through [Model Context Protocol](https://modelcontextprotocol.io) tools. Instead of writing REST calls by hand, an agent — Claude, Cursor, Windsurf, ChatGPT, or any MCP-capable client — connects to the server and calls Juicer tools to create feeds, add sources, moderate posts, pull analytics, manage the team, and look up social data.

<Info>
  Looking to let an agent **search these docs** instead of driving your account?
  See the [Documentation MCP](/mcp-docs-search) — a separate, read-only server
  for questions about the Juicer API. This page documents the **action** MCP
  Server that operates on your feeds and data.
</Info>

## How it works

Each MCP tool call is dispatched through the same API chain that powers the [REST API](/api-reference):

* Authentication of your API key
* Rate limiting for your plan tier
* Quota and usage enforcement
* The same controllers, validation, and serializers as the REST endpoints

The MCP Server holds no state of its own. It forwards every tool call to `https://api.juicer.io/v1` with your token and returns the API's response — including its structured error messages and upgrade hints — straight back to the agent. The result: **the MCP Server returns the same data and enforces the same rules as the REST API.**

## Who it's for

* **Agent builders** wiring an LLM up to Juicer to automate feed and content workflows.
* **Claude Code and Cursor users** who want to create feeds, add sources, and moderate posts from their editor.
* **Integrators** onboarding and managing feeds on behalf of many clients from a single account.

<Note>
  Every action runs as your Juicer account, with your exact plan limits and
  permissions. Team management tools (inviting users, assigning feeds) require
  an Enterprise or Team plan and an owner or manager API key.
</Note>

## Endpoint and transport

```text theme={null}
Endpoint:   https://api.juicer.io/mcp
Transport:  Streamable HTTP (stateless)
Auth:       OAuth 2.1 browser sign-in, or a jcr_ API key as a bearer token
```

## Relationship to the REST API

The MCP Server is a thin, hosted wrapper over the public API — not a separate product.

* The [**REST API**](/api-reference) is the underlying interface. Every endpoint is documented in the API Reference.
* The **MCP Server** exposes those same operations as tools an agent can call. Each tool maps to exactly one endpoint.

Anything you can do over MCP, you can do over REST, and vice versa. Reach for MCP when an agent should decide *which* calls to make; reach for REST when you're writing the integration yourself.

## Next steps

<CardGroup cols={2}>
  <Card title="Connect & Setup" icon="plug" href="/mcp-connect">
    Add the server to Claude, Cursor, VS Code, and more — with OAuth or an API key.
  </Card>

  <Card title="Tool Catalog" icon="wrench" href="/mcp-tools">
    The 33 tools the server exposes, grouped by domain with scope and purpose.
  </Card>

  <Card title="Documentation MCP" icon="magnifying-glass" href="/mcp-docs-search">
    A read-only server that lets agents search these docs in natural language.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    The REST endpoints every MCP tool maps to.
  </Card>
</CardGroup>