Skip to main content
Glama
Sign In
brave-image-mcp

brave-image-mcp

by ilker-tosun
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

brave-image-mcp

An MCP (Model Context Protocol) server for Brave Image Search API. Search images directly from AI assistants like Claude.

Author: Ilker Tosun License: MIT

Features

  • search_images — Search images with full filter support (country, language, safesearch, spellcheck)

  • search_images_batch — Run multiple image searches in a single call (up to 10 queries)

  • Returns image URLs, thumbnails, dimensions, source pages, and confidence scores

  • Proper error handling for rate limits, invalid keys, and bad parameters

Related MCP server: Brave Search MCP Server

Requirements

Installation

git clone https://github.com/ilker-tosun/brave-image-mcp.git
cd brave-image-mcp
npm install
npm run build

Configuration

Set your API key as an environment variable:

export BRAVE_API_KEY=your_api_key_here

Or add it to your MCP client config (see below).

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "brave-image-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/brave-image-mcp/dist/index.js"],
      "env": {
        "BRAVE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage with n8n (MCP Client Node)

  1. Build the project (npm run build)

  2. In n8n, add an MCP Client node

  3. Set transport to stdio

  4. Command: node /absolute/path/to/brave-image-mcp/dist/index.js

  5. Add environment variable: BRAVE_API_KEY=your_api_key_here

Tools

search_images

Search images for a single query.

Parameter

Type

Required

Description

query

string

✅

Search query (max 400 chars, 50 words)

count

number

❌

Results to return (1–200, default: 20)

country

string

❌

2-letter country code or ALL

search_lang

string

❌

Language code (e.g. en, tr)

safesearch

off | strict

❌

Content filter level

spellcheck

boolean

❌

Enable spell checking (default: true)

search_images_batch

Search images for multiple queries at once.

Parameter

Type

Required

Description

queries

string[]

✅

Array of queries (max 10)

count

number

❌

Results per query (1–200, default: 10)

country

string

❌

2-letter country code or ALL

search_lang

string

❌

Language code

safesearch

off | strict

❌

Content filter level

spellcheck

boolean

❌

Enable spell checking

Rate Limits

Plan

Limit

Free

1 req/sec

Pro

20 req/sec

License

MIT © Ilker Tosun

Available Tools

2 tools
search_imagesB

Search for images using the Brave Image Search API. Returns image URLs, thumbnails, dimensions, source pages, and metadata.

Inputs: query (required), count, country, safesearch, +2 more.

search_images_batchA

Search for images using multiple queries in a single call. Runs queries sequentially and returns combined results. Useful for collecting images across several topics at once.

Inputs: queries (required), count, country, safesearch, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 2 tools

    Disambiguation4/5

    The two tools are clearly differentiated by batch vs single query, and descriptions explicitly state this. However, since both are image searches, an agent might initially be unsure which to use without reading carefully.

    Naming Consistency5/5

    Both tools follow the same verb_noun pattern with a descriptive suffix ('batch' for the multi-query variant). The naming is consistent and predictable.

    Tool Count3/5

    With only two tools, the server feels thin for a general-purpose image search API. While the scope is narrow, a single search tool with a batch flag could have sufficed, making the current count borderline.

    Completeness4/5

    The core search capability is well covered, including a batch mode for multiple queries. Minor gaps exist, such as missing pagination or filtering options, but for an image search server the essential operations are present.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Brave Search MCP Server

      Shoofio
      A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that integrates the Brave Search API to provide both web and local search capabilities, with features like pagination, filtering, and smart fallbacks.
      16
      MIT

    • Brave Search MCP

      mikechao
      A
      license
      A
      quality
      D
      maintenance
      An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Image Search, Video Search, News Search and LLM Context Search capabilities
      5
      991 npm
      131
      GPL 3.0