Blogs MCP

Search blog posts. This server exposes one tool: search_webz_blogs.

MCP endpoint

https://blogs-mcp.webz.io/mcp

How it works

You write in normal language. The assistant calls GET /api/blogs with a q string it builds from your request.

Excerpt in each result is a clipped part of the post body (up to about 600 characters), not the full post.

Connect your client

Replace YOUR_WEBZ_TOKEN with your token.

Cursor

Add this to ~/.cursor/mcp.json (%USERPROFILE%\.cursor\mcp.json on Windows) and restart Cursor:

{
  "mcpServers": {
    "webz-blogs": {
      "url": "https://blogs-mcp.webz.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WEBZ_TOKEN"
      }
    }
  }
}

Token needs blogs (api_blogs) access. Setup: https://blogs-mcp.webz.io/.

Claude Desktop

Merge the same webz-blogs entry into your Claude Desktop config file - do not replace the whole file - then restart Claude Desktop:

Claude Code

Run in your project root:

claude mcp add --transport http webz-blogs https://blogs-mcp.webz.io/mcp --header "Authorization: Bearer YOUR_WEBZ_TOKEN"

n8n

Add an MCP Client Tool node and connect it to an AI Agent node's Tool input:

Create a Bearer Auth credential and paste your Webz.io API token as the bearer token. The agent receives a search_webz_blogs tool.

Claude.ai and ChatGPT (web)

Add https://blogs-mcp.webz.io/mcp as a custom connector (Claude.ai: Settings > Connectors; ChatGPT: Settings > Apps & Connectors with Developer mode on). Both use OAuth: leave Client ID and Secret empty, then paste your Webz token on the authorize page. Setup instructions for every client are at blogs-mcp.webz.io.

End-to-end example

1. What you ask

Find English blog posts from the past week about supply chain delays on Medium.

2. What the assistant calls

Tool: search_webz_blogs

If site:medium.com returns zero posts, the assistant should broaden the query (drop site: or widen the topic) and call the tool once more.

3. What the MCP tool returns

Example when posts exist:

Query: "supply chain" delays site:medium.com language:english
Total results: 14
More results available: 4
Requests left: 790

--- Result 1 ---
Title: Why port backlogs still ripple through retail blogs
URL: https://medium.com/example/why-port-backlogs-still-ripple-2026
Published: 2026-10-11T14:22:00.000+03:00
Site: medium.com
Site type: blogs
Language: english
Excerpt: Retailers that diversified suppliers after 2022 are still seeing two-week slips on inbound containers. Blog authors argue that "just in time" is returning slowly, but finance teams want proof before they cut safety stock again...

--- Result 2 ---
Title: Supply chain delays are not just a shipping story
URL: https://medium.com/example/supply-chain-delays-are-not-just-shipping
Published: 2026-10-09T09:05:00.000+03:00
Site: medium.com
Site type: blogs
Language: english
Excerpt: Component lead times for industrial controllers lengthened again in Q3. The post walks through vendor allocation letters and why assembly lines pause even when freight looks healthy...

Example when nothing matches (successful API call, zero hits):

Query: "supply chain" delays site:medium.com language:english
Total results: 0
More results available: 0
Requests left: 791

No posts matched this search. The API call succeeded; there is simply no content for this query right now.
If this was the first try, call this tool once more with a broader q (drop site:, language:, country:, category, sentiment, or tight phrases; widen the topic or increase days).

4. What you see from the assistant

I searched English Medium blogs from the last 7 days for supply chain delays. Webz found 14 posts; here are the main themes from the top results: port and container backlogs affecting retail inventory decisions, and longer component lead times beyond shipping alone. [Link to first post], [link to second post]. If you want non-Medium blogs too, I can rerun without site:medium.com.

Tool parameters (simple view)

Space calls by at least 1 second on this server to avoid rate limits.

More detail

• Blogs API
• Blog filters
• Query syntax