# Caisy MCP by usefulapi

> Caisy MCP by usefulapi is a freemium MCP server for content publishing. Hosted MCP server giving AI clients read-only access to a Caisy CMS project. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/caisy/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/caisy
- **MCP Registry name:** io.usefulapi/caisy
- **Categories:** content publishing
- **Listing updated:** 2026-11-18

## About

The README describes this as a hosted remote server for reading blueprints, documents and media assets from one Caisy project. Nothing needs to be installed locally; an AI client connects to a URL and then signs in with a Caisy project ID and API key.

The server exposes four read tools that run GraphQL queries, list query fields, page through document ids of a blueprint, and list media assets with their source URLs. Four further tools handle usage status, feature requests, and upgrading or cancelling the usefulapi subscription. The site states that all four data tools are read-only and that mutations and subscriptions are refused.

It suits content teams and developers who want to ask questions about a Caisy project in Claude, ChatGPT, Cursor or another MCP-capable client. The service is operated by usefulapi, which the site says is independent of Caisy.

## Features

- **Read-only GraphQL queries:** Runs single read queries with filters, sorting, nested fields and localized values, while refusing mutations.
- **Blueprint discovery:** Lists the project's read query fields so clients can find the blueprint API ids.
- **Document id paging:** Pages through document ids of a blueprint using Relay cursors.
- **Media asset listing:** Lists media assets with their titles and source URLs, page by page.
- **OAuth sign-in:** Clients log in through a browser page that asks for the Caisy project ID and API key, with no keys in config files.

## Good for

- Finding which pages in a Caisy project are not yet published
- Counting documents in each blueprint of a project
- Reading localized field values for a single entry
- Listing recent media assets and their URLs

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http caisy https://caisy.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://caisy.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "caisy": {
      "url": "https://caisy.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "caisy": {
      "type": "http",
      "url": "https://caisy.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "caisy": {
      "serverUrl": "https://caisy.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "caisy": {
      "type": "http",
      "url": "https://caisy.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `caisy_run_query`: Run one read-only GraphQL query against the project's Caisy external API.
- `caisy_list_queries`: List the top-level read fields of the project's Caisy schema.
- `caisy_list_documents`: List document ids of one blueprint with Relay pagination.
- `caisy_list_assets`: List media assets (title and source URL) with Relay pagination.

## FAQ

### Is this an official Caisy product?

No. The site says usefulapi is an independent service and is not affiliated with or endorsed by Caisy.

### Can the AI change my Caisy data?

The site says all four Caisy data tools are marked read-only, and that mutations and subscriptions are refused.

### What does it cost?

The Free plan gives 50 tool calls per month. Pro is $9/mo or $90/yr with 10,000 calls per month, and Pro+ is $39/mo or $390/yr with 100,000 calls per month.

### What do I need to connect?

The login page asks for your Caisy project ID and a Caisy API key, which you create under Settings → Development → API Keys.

### Is Caisy MCP by usefulapi free?

Caisy MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Caisy MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http caisy https://caisy.usefulapi.io/mcp

### What are the best alternatives to Caisy MCP by usefulapi?

The closest alternatives to Caisy MCP by usefulapi are Medium MCP Server and API by Cotlet, JubJub, Shiro, Twinpost and Dinoctor.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Medium MCP Server and API by Cotlet](https://ai-powered.com/mcp/medium-mcp-server-and-api-by-cotlet): Medium MCP Server and API by Cotlet is a freemium MCP server for content publishing.
- [JubJub](https://ai-powered.com/mcp/jubjub): JubJub is a freemium MCP server for content publishing.
- [Shiro](https://ai-powered.com/mcp/shiro): Shiro is a freemium MCP server for content publishing.
- [Twinpost](https://ai-powered.com/mcp/twinpost): Twinpost is an MCP server for content publishing.
- [Dinoctor](https://ai-powered.com/mcp/dinoctor): Dinoctor is a freemium MCP server for content publishing.
- [dev.to Developer Blogs & Programming Tutorials — buy per-query (devtowatch)](https://ai-powered.com/mcp/dev-to-developer-blogs-and-programming-tutorials-buy-per-que): dev.to Developer Blogs & Programming Tutorials — buy per-query (devtowatch) is a paid MCP server for content publishing.
- [unflick](https://ai-powered.com/mcp/unflick): unflick is an open-source MCP server for content publishing.
- [VideoDB](https://ai-powered.com/mcp/videodb): VideoDB is a freemium MCP server for content publishing.

---
Source: https://ai-powered.com/mcp/caisy-mcp-by-usefulapi
