Bowrd MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bowrd MCP Server pin this image to my recipes board: https://example.com/cake.jpg"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Bowrd MCP Server
A Model Context Protocol (MCP) server for Bowrd — the minimalist, self-hosted visual bookmarking platform and Pinterest alternative with ActivityPub / Fediverse integration.
This server enables AI assistants (Claude Desktop, Cursor, Antigravity, OpenClaw, Hermes, etc.) to browse your boards, search bookmarks, scrape images from the web, and pin visual inspirations directly into your Bowrd instance.
Features & Tools
Tool | Description | Parameters |
| List all boards with IDs, names, slugs, descriptions, and pin counts. | None |
| Create a new board. |
|
| List pins/entries from Bowrd, optionally filtered by board. |
|
| Retrieve full details of a single pin by ID or UUID. |
|
| Pin an image to a board. Bowrd automatically downloads and stores the media. |
|
| Update an existing pin (edit title, description, content warning, tags, move board, or visibility). |
|
| Search through your pins by keyword in title, description, or source URL. |
|
| Scrape a webpage to find images, title, and description using Bowrd's image finder. |
|
Related MCP server: pinterest-mcp
Quickstart
1. Prerequisites
Node.js
>= 20A running self-hosted Bowrd instance with the API bridge enabled (see Bowrd Backend Setup below).
2. Installation & Build
git clone https://github.com/Robert-SD/bowrd-mcp.git
cd bowrd-mcp
npm install
npm run build3. Environment Configuration
Copy .env.example to .env:
cp .env.example .envSet your Bowrd URL and secret API token:
BOWRD_URL=https://your-bowrd-domain.com
BOWRD_API_TOKEN=your_generated_mcp_tokenClient Integration
Claude Desktop
Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"bowrd": {
"command": "npx",
"args": ["-y", "bowrd-mcp"],
"env": {
"BOWRD_URL": "https://your-bowrd-domain.com",
"BOWRD_API_TOKEN": "your_generated_mcp_token"
}
}
}
}(If running from local source clone, replace "command": "npx", "args": ["-y", "bowrd-mcp"] with "command": "node", "args": ["/path/to/bowrd-mcp/dist/index.js"])
Cursor
Add to .cursor/mcp.json in your workspace or global settings:
{
"mcpServers": {
"bowrd": {
"command": "npx",
"args": ["-y", "bowrd-mcp"],
"env": {
"BOWRD_URL": "https://your-bowrd-domain.com",
"BOWRD_API_TOKEN": "your_generated_mcp_token"
}
}
}
}Google Antigravity (agy)
Install directly via the Antigravity plugin manager:
agy plugin install https://github.com/Robert-SD/bowrd-mcpMake sure BOWRD_URL and BOWRD_API_TOKEN are set in your environment.
Safety & Guardrails
Non-Destructive Operations: To protect your visual library from unintended AI hallucination or accidental mass deletion, Bowrd MCP deliberately exposes strictly additive, reading, and searching tools. Deletions cannot be performed via MCP.
Bowrd Backend Setup
As upstream Bowrd does not currently ship with an official REST API, this MCP server pairs with a lightweight API bridge controller included in laravel/McpApiController.php.
Step 1: Copy Controller
Copy laravel/McpApiController.php into your Bowrd project directory:
cp laravel/McpApiController.php <path-to-bowrd>/app/Http/Controllers/McpApiController.phpStep 2: Register API Routes
Add the following to <path-to-bowrd>/routes/web.php:
use App\Http\Controllers\McpApiController;
Route::prefix('api/mcp')->group(function () {
Route::get('/boards', [McpApiController::class, 'boards']);
Route::post('/boards', [McpApiController::class, 'createBoard']);
Route::get('/entries', [McpApiController::class, 'entries']);
Route::get('/entries/{id}', [McpApiController::class, 'entry']);
Route::post('/entries', [McpApiController::class, 'createEntry']);
Route::put('/entries/{id}', [McpApiController::class, 'updateEntry']);
Route::patch('/entries/{id}', [McpApiController::class, 'updateEntry']);
Route::get('/search', [McpApiController::class, 'search']);
Route::post('/fetch-images', [McpApiController::class, 'fetchImages']);
});
Step 3: Exclude from CSRF Protection
In <path-to-bowrd>/bootstrap/app.php (Laravel 11+), ensure api/* is excluded from CSRF verification:
->withMiddleware(function (Middleware $middleware) {
$middleware->validateCsrfTokens(except: [
'api/*',
'@*/inbox',
]);
})Step 4: Configure Token in .env
Add an MCP token to your Bowrd .env:
MCP_API_TOKEN=your_secure_random_token_here(Optionally specify ADMIN_EMAIL=user@example.com if you want API actions explicitly tied to a specific account).
Restart or rebuild your Bowrd container stack:
docker compose up -dDevelopment
# Run with live TypeScript execution
npm run dev
# Compile TypeScript
npm run buildLicense
This project is licensed under the MIT License.
Available Tools
8 toolsbowrd_create_boardCreate BoardB
Create a new board in Bowrd for organizing visual bookmarks.
Inputs: name (required), is_public, description.
bowrd_create_entryCreate Entry (Pin Image)A
Create a new pin/entry in Bowrd. Automatically downloads the image to Bowrd storage and attaches it to the specified board.
Inputs: title (required), board_id (required), image_url (required), tags, +3 more.
bowrd_get_entryGet EntryARead-only
Retrieve detailed information about a single pin/entry by its ID or UUID.
Inputs: entry_id (required).
bowrd_list_boardsList BoardsARead-only
List all boards in Bowrd with their ID, name, slug, description, and pin counts.
Inputs: no named parameters.
bowrd_list_entriesList EntriesARead-only
List pins/entries from Bowrd, optionally filtered by a specific board ID.
Inputs: limit, board_id.
bowrd_scrape_images_from_urlScrape Images From URLARead-only
Scrape a webpage URL to automatically find images, title, and description using Bowrd's image finder service.
Inputs: url (required).
bowrd_search_entriesSearch EntriesARead-only
Search through your Bowrd pins by matching keywords in title, description, or source URL.
Inputs: query (required), limit.
bowrd_update_entryUpdate EntryBDestructive
Update an existing pin/entry (edit title, description, content warning, tags, change visibility, or move to another board).
Inputs: entry_id (required), tags, title, board_id, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct resource and action: search vs. list entries are separated by keyword search versus board-filtered listing, and entry operations are distinct from board operations. The scrape tool is also clearly unique as a URL extraction helper.
All tools follow the same bowrd_ prefix plus snake_case verb_noun pattern: search_entries, list_boards, create_board, list_entries, create_entry, get_entry, update_entry. Scrape_images_from_url is slightly longer but still obey the same convention.
Eight tools is well-scoped for a visual bookmarking server covering boards and pins. Each tool occupies a distinct role without excessive surface area.
Entry lifecycle is mostly covered with create, list, search, get, and update, but delete is missing. Boards only have list and create, with no get, update, or delete operations, leaving notable gaps for board management.
Maintenance
Related MCP Connectors
Pinterest automation: schedule pins, manage boards, write AI blogs and auto-pin them.
Your agent needs Pinterest as a demand signal — what people are saving in a category, which pins earn engagement, what a competitor's boards are collecting. **What you can ask for** • "What pins come up for 'home office setup', and which get saved most?" • "Page through this board and list the products it links to." • "Which boards does this user keep, and what are they about?" • "Show the engagement on this pin." **How to use it** Point any MCP client at https://mcp.aisa.one/pinterest/mcp and sign in with OAuth — there is no key to create or paste. 4 read tools: search pins, read one pin and its engagement, page through a board, and list a user's boards. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Spot the trend here, then ask the same agent for search volume on the same phrase or who already ranks for it — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/social/mcp for X plus Instagram, Reddit, Pinterest and YouTube; https://mcp.aisa.one/gtm/mcp for those plus Similarweb and Apollo.
Create Pinterest pins from blog posts and Shopify/Etsy products, and schedule them to your boards.
Save and organize web finds in persistent, user-controlled collections for AI assistants.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the Pinterest API, allowing management of boards and pins through natural language commands.41MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Pinterest boards and pins, create and update pins, and track analytics via the Pinterest API v5.8MIT
- AlicenseAqualityCmaintenanceEnables AI agents to manage Pinterest accounts through the Pinterest API v5, including creating and editing pins, organizing boards, searching public content, and retrieving pin and account analytics.11MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to read and manage an account's boards, pins, sections, and analytics, run full-text search over its own content, and complete OAuth token flows through the Pinterest API v5. It exposes 35 typed tools that run either as a local stdio subprocess or as a stateless remote HTTP endpoint with built-in OAuth 2.1 support.3528 npm3MIT