Bowrd MCP server
Commit Oct 17, 2026Enables AI assistants to browse boards, search bookmarks, scrape images, and pin visual inspirations to a self-hosted Bowrd instance.
Also known as Robert-SD/bowrd-mcp
- Stars
- 0
- Tools
- 8
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Oct 17, 2026
- License
- MIT
What is Bowrd MCP?
Bowrd enables AI assistants to browse boards, search bookmarks, scrape images, and pin visual inspirations to a self-hosted Bowrd instance. It exposes 8 tools, such as bowrd_list_boards, bowrd_create_board, bowrd_list_entries.
Summary generated from the project's README
About Bowrd MCP server
Managing visual collections and bookmarks through an AI assistant is possible with this server. It connects to a self-hosted Bowrd instance, which is a minimalist, Fediverse-integrated alternative to Pinterest. Users can integrate this with clients like Claude Desktop, Cursor, or Antigravity by providing their Bowrd URL and a secret API token in their configuration.
The server provides tools to browse boards, search through existing pins, and create new entries. It includes a specific tool to scrape images from a webpage, allowing the AI to find titles and descriptions automatically. Because the server focuses on additive and reading operations, it prevents accidental deletions of your visual library.
To use it, you must have a running Bowrd instance with the API bridge controller installed and configured. Once set up, the AI can list boards using bowrd_list_boards, search for specific content with bowrd_search_entries, or pin new images using bowrd_create_entry.
What you can do with it
- 1Extract images from websitesHave the assistant scrape a webpage to find and save interesting images for your collection.
- 2Search your bookmarksFind specific pins in your collection by searching for keywords in titles or descriptions.
- 3Update existing pinsInstruct the AI to modify the tags or description of a pin you have already saved.
Written from the project's README. Every use case is checked against a quote from it.
Bowrd MCP tools 8
Detected from the READMEbowrd_list_boardsbowrd_create_boardbowrd_list_entriesbowrd_get_entrybowrd_create_entrybowrd_update_entrybowrd_search_entriesbowrd_scrape_images_from_url
Configuration
BOWRD_API_TOKENBOWRD_URLMCP_API_TOKEN
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablerobert-sd/bowrd-mcp is public and reachablegithub.com/robert-sd/bowrd-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-17github.com/robert-sd/bowrd-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBowrd 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 |
|---|---|---|
bowrd_list_boards |
List all boards with IDs, names, slugs, descriptions, and pin counts. | None |
bowrd_create_board |
Create a new board. | name (required), description (optional), is_public (default: true) |
bowrd_list_entries |
List pins/entries from Bowrd, optionally filtered by board. | board_id (optional), limit (1-50, default: 20) |
bowrd_get_entry |
Retrieve full details of a single pin by ID or UUID. | entry_id (required) |
bowrd_create_entry |
Pin an image to a board. Bowrd automatically downloads and stores the media. | board_id (required), title (required), image_url (required), source_url (optional), description (optional), tags (optional array), is_public (default: true) |
bowrd_update_entry |
Update an existing pin (edit title, description, content warning, tags, move board, or visibility). | entry_id (required), title (optional), description (optional), board_id (optional), tags (optional array), is_public (optional), content_warning (optional) |
bowrd_search_entries |
Search through your pins by keyword in title, description, or source URL. | query (required), limit (default: 20) |
bowrd_scrape_images_from_url |
Scrape a webpage to find images, title, and description using Bowrd's image finder. | url (required) |
Quickstart
1. Prerequisites
- Node.js
>= 20 - A 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 build
3. Environment Configuration
Copy .env.example to .env:
cp .env.example .env
Set your Bowrd URL and secret API token:
BOWRD_URL=https://your-bowrd-domain.com
BOWRD_API_TOKEN=your_generated_mcp_token
Client 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-mcp
Make 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.php
Step 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 -d
Development
# Run with live TypeScript execution
npm run dev
# Compile TypeScript
npm run build
License
This project is licensed under the MIT License.
Bowrd MCP questions
What tools does Bowrd MCP provide?
It exposes 8 tools, including bowrd_list_boards, bowrd_create_board, bowrd_list_entries, bowrd_get_entry, bowrd_create_entry.
Can the AI delete my pins?
No, the server is designed to be non-destructive. It only exposes tools for reading, searching, and adding content to prevent accidental mass deletion.
How do I pin an image to a board using the AI?
You can use the bowrd_create_entry tool, which allows you to provide a board ID, title, and image URL; Bowrd will then automatically download and store the media.