https://github.com/bludit/bludit-mcp
https://github.com/bludit/bludit-mcp
Last synced: 14 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/bludit/bludit-mcp
- Owner: bludit
- License: mit
- Created: 2026-05-09T13:41:29.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-10T18:13:34.000Z (about 1 month ago)
- Last Synced: 2026-05-10T20:18:03.272Z (about 1 month ago)
- Language: JavaScript
- Size: 16.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bludit-mcp
MCP server for [Bludit CMS](https://www.bludit.com). Lets any MCP-compatible AI client (Claude Desktop, Gemini CLI, Cursor, Zed, Windsurf, Continue.dev, and others) read and write Bludit pages over the HTTP API.
## Requirements
- Node.js 18+.
- Bludit 3.22.0+ with the API plugin enabled.
- Bludit's API token.
- Bludit's user AUTH token.
## Environment variables
| Variable | Required | Description |
|----------|----------|-------------|
| `BLUDIT_URL` | yes | Site root, e.g. `https://www.example.com`. No trailing slash needed |
| `BLUDIT_API_TOKEN` | yes | Admin Panel → Plugins → API → Settings → API token |
| `BLUDIT_AUTH_TOKEN` | yes | The user's authentication token. Admin Panel → Users → admin → Security tab → Token |
## Install it on Claude Desktop
### 0. Install Claude Desktop on your PC.
- https://code.claude.com/docs/en/desktop
### 1. Open the Developer settings
In Claude Desktop, go to **Settings → Developer** and click **Edit Config**, then edit the file `claude_desktop_config.json`.
### 2. Add the Bludit entry and save
Add the Bludit server inside the `mcpServers` block, then save the file and restart Claude Desktop.
```json
{
"mcpServers": {
"bludit": {
"command": "npx",
"args": ["-y", "bludit-mcp"],
"env": {
"BLUDIT_URL": "https://www.example.com",
"BLUDIT_API_TOKEN": "...",
"BLUDIT_AUTH_TOKEN": "..."
}
},
...
},
"preferences": {
"coworkScheduledTasksEnabled": true,
...
}
}
```
### 3. Verify the server is running
After restarting Claude Desktop, the Bludit MCP should appear in the **Running** state.
### 4. Try it out
Ask any question related to pages. You can create, edit, delete, or just list them.
- List existing pages: *What pages do I currently have on my blog?*
- Brainstorm + Create: *I'm a travel writer and I need a catchy title and intro paragraph for a post about slow travel in rural Spain. Create a new draft page with it.*
- Edit / refine: *That intro is good but too formal. Rewrite it with a more casual, personal tone and update the page.*
- Delete: *That was just a draft, I don't need it anymore — delete the 'Salt and Sun' page.*
## Install on Claude Code CLI
```bash
claude mcp add bludit \
-e BLUDIT_URL=https://www.example.com \
-e BLUDIT_API_TOKEN=... \
-e BLUDIT_AUTH_TOKEN=... \
-- npx -y bludit-mcp
```
Check if the MCP is running
```bash
claude mcp list
...
bludit: npx -y bludit-mcp - ✓ Connected
```
## Install on Gemini CLI
```
gemini mcp add bludit npx -y bludit-mcp \
-e BLUDIT_URL=https://www.example.com \
-e BLUDIT_API_TOKEN=... \
-e BLUDIT_AUTH_TOKEN=...
```
Check if the MCP is running
```
gemini mcp list
Configured MCP servers:
✓ bludit: npx -y bludit-mcp (stdio) - Connected
```
## Tools
| Tool | Description | Auth |
|------|-------------|------|
| `list_pages` | List pages with filters (`published`, `draft`, `static`, `sticky`, `scheduled`, `untagged`) and pagination. | API token |
| `get_page` | Get a single page by key. | API token |
| `create_page` | Create a new page. Returns the full page object. | API + auth |
| `edit_page` | Edit a page. Pass only the fields you want to change. | API + auth |
| `delete_page` | Delete a page by key. | API + auth |
## License
MIT. See [LICENSE](LICENSE).