---
title: "Ring MCP Tools"
description: "Model Context Protocol reference for Ring Platform clones — ring-mcp gateway, kingdom vs clone scope, and per-tool operator pages"
locale: "en"
---
# Ring MCP Tools

**Connect Cursor, Claude Desktop, or any MCP host to a running Ring clone** and operate entities, news, store, messaging, and generative media from natural language.

Ring ships a **service-token HTTP gateway** at `/api/mcp/v1/*` on each clone. The stdio server **`ring-mcp`** (`AI-RING/ring-mcp/`) exposes `ring-*` tools that call that gateway as a synthetic **SUPERADMIN** actor. This section documents **individual tools**; the full operator manual lives under [Ring MCP Server](/docs/development/ring-mcp.md).

  
- **[Ring MCP Server (operator manual)](/docs/development/ring-mcp.md)** — Install ring-mcp, configure tokens, full 58-tool catalog, troubleshooting.

  
- **[Generative images (ImageConductor)](/docs/development/generative-images.md)** — Provider architecture, env block, admin UI — shared backend for image tools.

  
- **[Generative videos (VideoConductor)](/docs/development/generative-videos.md)** — Draft 480p vs production 720p, remaster workflow, CLI manifest.

  
- **[Environment configuration](/docs/deployment/environment.md)** — `RING_MCP_ACCESS_KEY`, image generation keys, ring-filebase storage.

```mermaid
flowchart LR
  Host["MCP host\n(Cursor, Claude)"]
  RingMcp["ring-mcp\nAI-RING/ring-mcp"]
  Gateway["/api/mcp/v1/*\nRing clone"]
  Services["features/*/services"]
  DB[("PostgreSQL / storage")]

  Host --> RingMcp --> Gateway --> Services --> DB

  subgraph Kingdom["Kingdom MCP — different scope"]
    Legiox["legiox-mcp"]
    Ringdom["ringdom-mcp"]
    Reggie["reggie-mcp"]
  end
```

## What is MCP?

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) is an open standard for connecting AI applications to external data and tools. Ring implements MCP in two layers:

| Layer | Package / server | Scope |
|-------|------------------|-------|
| **Per-clone operator** | `ring-mcp` → `/api/mcp/v1/*` | One white-label instance (this section) |
| **Kingdom-wide** | `legiox-mcp`, `ringdom-mcp`, `reggie-mcp` | AI-CONTEXT, deployment, propagation across Ringdom |

Ring's user-facing REST routes use **Auth.js session cookies**. The MCP gateway validates `Authorization: Bearer` against `RING_MCP_ACCESS_KEY` and injects a service actor — see [Ring MCP Server — Architecture](/docs/development/ring-mcp.md#architecture-notes).

## Prerequisites

| Requirement | Notes |
|-------------|--------|
| Node.js 20+ | Ring Platform baseline |
| Running Ring clone | `npm run dev` or production deploy |
| `RING_MCP_ACCESS_KEY` | On the **Ring app** `.env.local` |
| `RING_MCP_ACCESS_KEY` | In Cursor `.cursor/mcp.json` — must match one server token |
| `ring-mcp` registered | `AI-RING/ring-mcp/ring-mcp-server.js` in MCP client config |

{`cd AI-RING/ring-mcp
npm install
node ring-mcp-server.js --test

RING_API_BASE_URL=http://localhost:3000 \\
RING_MCP_ACCESS_KEY=your-token \\
npm run smoke`}

## Tool catalog

Each card links to a dedicated reference page. Pages are added as tools ship.

  
- **[ring-image-create](/docs/mcp/ring-image-create.md)** — Generate images via ImageConductor (xAI / Google Imagen) → ring-filebase CDN URL.

  
- **[ring-video-create](/docs/mcp/ring-video-create.md)** — Generate videos via VideoConductor — draft 480p or production 720p remaster.

Additional `ring-*` tools (entities, news, store, `ring-news-generate`, etc.) are documented in the [Ring MCP Server](/docs/development/ring-mcp.md#tool-reference-58-tools) operator manual. Per-tool pages under `/docs/mcp/` will appear here as they are authored.

## Response contract

All `/api/mcp/v1/*` handlers return uniform JSON:

{`{
  "success": true,
  "data": { }
}`}

{`{
  "success": false,
  "error": "Human-readable message"
}`}

Destructive `ring-*` mutations require **`confirm: true`** in tool arguments — do not bypass in wrappers.

## Related

  
- **[Autonomous newsroom](/docs/development/generative-newsroom.md)** — `ring-news-generate` — cited drafts with featured images.

  
- **[Doc system](/docs/features/doc-system.md)** — MDX components used on these pages.