Skip to content
MCP server

ButterCMS MCP by usefulapi

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

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About ButterCMS MCP by usefulapi

ButterCMS MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://buttercms.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "buttercms": {
      "url": "https://buttercms.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (15)

Read directly from the server.

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}/.

ButterCMS MCP by usefulapi 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