# Blogs MCP

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

## MCP endpoint

```text
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:

```json
{
  "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:

| OS | Config file |
| --- | --- |
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Linux | `~/.config/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |

### Claude Code

Run in your project root:

```bash
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:

| Field | Value |
| --- | --- |
| Endpoint | `https://blogs-mcp.webz.io/mcp` |
| Server Transport | `HTTP Streamable` |
| Authentication | `Bearer Auth` |
| Tools to Include | `All` |

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](https://blogs-mcp.webz.io/).

> [!NOTE]
> Opening the `/mcp` endpoint in a browser returns `401 Unauthorized` by design - browsers do not send your token. Use an MCP client.

## 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`

| Argument | Value |
|----------|--------|
| `days` | `7` |
| `q` | `"supply chain" delays site:medium.com language:english` |
| `size` | `10` |
| `sort` | `published` |

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:

```text
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):

```text
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)

| Parameter | You usually say… | What the tool does |
|-----------|------------------|-------------------|
| `q` | site, author, topic | blogs search query |
| `days` | time window | lookback in days |
| `size` | how many results | page size |

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

## More detail

- [Blogs API](blogs)
- [Blog filters](blogs-api-filters)
- [Query syntax](news-blogs-forums-query-syntax)