Skip to main content
Glama

Bowrd MCP Server

License: MIT MCP

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)


Related MCP server: pinterest-mcp

Quickstart

1. Prerequisites

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.

Available Tools

8 tools
bowrd_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 EntryA
Read-only

Retrieve detailed information about a single pin/entry by its ID or UUID.

Inputs: entry_id (required).

bowrd_list_boardsList BoardsA
Read-only

List all boards in Bowrd with their ID, name, slug, description, and pin counts.

Inputs: no named parameters.

bowrd_list_entriesList EntriesA
Read-only

List pins/entries from Bowrd, optionally filtered by a specific board ID.

Inputs: limit, board_id.

bowrd_scrape_images_from_urlScrape Images From URLA
Read-only

Scrape a webpage URL to automatically find images, title, and description using Bowrd's image finder service.

Inputs: url (required).

bowrd_search_entriesSearch EntriesA
Read-only

Search through your Bowrd pins by matching keywords in title, description, or source URL.

Inputs: query (required), limit.

bowrd_update_entryUpdate EntryB
Destructive

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

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    Eight tools is well-scoped for a visual bookmarking server covering boards and pins. Each tool occupies a distinct role without excessive surface area.

    Completeness3/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    • Pinterest automation: schedule pins, manage boards, write AI blogs and auto-pin them.

      https://365pinterest.com/mcp
    • 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.

      https://pinbuilds.com/api/mcp
    • Save and organize web finds in persistent, user-controlled collections for AI assistants.

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to manage Pinterest boards and pins, create and update pins, and track analytics via the Pinterest API v5.
      8
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      11
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      35
      28 npm
      3
      MIT