# ButterCMS MCP by usefulapi

> ButterCMS MCP by usefulapi is an MCP server. Read blog posts, authors, categories, tags, pages and collection items in ButterCMS. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/buttercms/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/buttercms
- **MCP Registry name:** io.usefulapi/buttercms
- **Listing updated:** 2026-11-13

## About

Read blog posts, authors, categories, tags, pages and collection items in ButterCMS.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `buttercms_list_posts`: List published blog posts, newest first, with optional filters by author, category or tag. Use exclude_body to get short results. Read API: GET /posts/.
- `buttercms_get_post`: Get one blog post by slug, with the full body, metadata, and the next and previous posts. Read API: GET /posts/{slug}/.
- `buttercms_search_posts`: Full-text search in blog post titles, bodies and summaries. Results are sorted by relevance. Read API: GET /posts/search/.
- `buttercms_list_authors`: List all blog authors. Set include to 'recent_posts' to embed the recent posts of each one. Read API: GET /authors/.
- `buttercms_get_author`: Get one blog author by slug. Set include to 'recent_posts' to embed the recent posts. Read API: GET /authors/{slug}/.
- `buttercms_list_categories`: List all blog categories. Set include to 'recent_posts' to embed the recent posts of each one. Read API: GET /categories/.
- `buttercms_get_category`: Get one blog category by slug. Set include to 'recent_posts' to embed the recent posts. Read API: GET /categories/{slug}/.
- `buttercms_list_tags`: List all blog tags. Set include to 'recent_posts' to embed the recent posts of each one. Read API: GET /tags/.
- `buttercms_get_tag`: Get one blog tag by slug. Set include to 'recent_posts' to embed the recent posts. Read API: GET /tags/{slug}/.
- `buttercms_list_pages`: List pages of one page type, or all Single Pages with page_type '*'. Filtering and ordering work only for a real page type. Read API: GET /pages/{page_type}/.
- `buttercms_get_page`: Get one page by page type and slug. Use '*' as page_type for a Single Page. Read API: GET /pages/{page_type}/{page_slug}/.
- `buttercms_search_pages`: Search the direct content of pages by text. Results are sorted by relevance. Read API: GET /pages/search/.
- `buttercms_get_collections`: Get the items of one or more collections at once. Every key must be an existing collection key. Read API: GET /content/?keys=a,b.
- `buttercms_list_collection_items`: List the items of one collection, with paging, ordering and field filters. Each item meta.id is the item id. Read API: GET /content/{collection_key}/.
- `buttercms_get_collection_item`: Get one collection item by its numeric id. Read API: GET /content/{collection_key}/{item_id}/.

## FAQ

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

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

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