MCP server
Give any MCP-capable agent live web search, image search and fetch — with the exact same parameters as the REST API.
Watch · 2 min
LM Studio
Add Blopus as an MCP server in LM Studio, end to end.
Watch · 2 min
OpenCode
The same config in OpenCode, with live web search working at the end.
What is MCP?#
The Model Context Protocol is an open standard for connecting AI assistants to tools and data. Blopus ships an MCP server so agents like Claude, Cursor, and Cline can call search, search_images and fetch as native tools — no glue code.
The Blopus MCP tools expose the same parameters documented in the REST reference. Authenticate with Authorization: Bearer blp_live_…, exactly like REST.
Generic mcpServers config#
Most clients accept a JSON block like this. Drop in your key and point at the Blopus endpoint:
Official MCP registry#
Blopus is published in the official MCP Registry
under the first-party name ai.blopus/search. Clients and directories that read
the registry can discover the server without you pasting a URL at all:
The registry entry only tells a client where Blopus lives. You still supply your own
Authorization: Bearer blp_live_… header — the listing carries no credentials.
The four tools
Connecting Blopus exposes four tools. A model picks between them on its own, but knowing what they cost helps when you are debugging why an agent is behaving oddly.
| Tool | Cost | What it is for |
|---|---|---|
search | 1 credit per block of 10 results | Find pages. Returns
title, url, snippet, date, word_count and topics. Snippets are for choosing what to
read. |
search_images | 1 credit per block of 10 results | Find
pictures. Ranks the image index itself, so it returns pictures of the subject.
Not the same as search(include_images=true), which runs a web
search and hands back whatever hero image those articles happened to use. |
fetch | 1 credit per block of 10 URLs | Read pages in full. Always batch — ten URLs in one call cost the same as one search, while ten separate calls cost ten times that. |
blopus_topics | free | List the subject areas
you may pass to topics / exclude_topics. Unbilled on purpose: topics are
exact-match, so a guessed value returns zero results, and charging for discovery would guarantee
guessing. Call it once and reuse the answer. |
The 40 most-used topics are listed inline on the search tool, so common cases
need no extra call at all. blopus_topics is for the long tail.
Clients that show friendly names will display these as Web Search, Image Search, List Topics and Fetch Page Content. All four are annotated read-only, so an agent knows none of them mutate anything.
A topic describes what a publication covers, not what an article is about.
topics=["ai"] means “pages from AI-focused sites”, which is broader than
“pages about AI”. Use it to scope or de-noise, never as a substitute for the query.
Claude Code & Claude Desktop#
Add Blopus with the Claude Code CLI (HTTP transport):
Cursor#
Add to ~/.cursor/mcp.json (or a project .cursor/mcp.json):
Cline#
In Cline's MCP settings, add a remote server with the same shape:
Windsurf#
Add to ~/.codeium/windsurf/mcp_config.json:
LM Studio#
Edit mcp.json from the LM Studio Program tab and add Blopus: