---
title: "For AI agents"
url: "https://vanducng.dev/agents/"
date: "2026-10-24"
---

# For AI agents

## Connect your agent

The MCP server lives at `https://mcp.vanducng.dev/mcp`. It needs no key and only reads public posts.

### Claude Code

```bash
claude mcp add --transport http vanducng https://mcp.vanducng.dev/mcp
```

### Claude Desktop and claude.ai

Settings → Connectors → Add custom connector, then paste the URL above.

### Cursor `~/.cursor/mcp.json`

```json
{
  "mcpServers": {
    "vanducng": { "url": "https://mcp.vanducng.dev/mcp" }
  }
}
```

### VS Code `.vscode/mcp.json`

```json
{
  "servers": {
    "vanducng": { "type": "http", "url": "https://mcp.vanducng.dev/mcp" }
  }
}
```

### Clients that only speak stdio

```bash
npx -y mcp-remote https://mcp.vanducng.dev/mcp
```

## Tools

| Tool | What it does |
|------|--------------|
| `search_posts` | Keyword search over titles, tags, series, headings and summaries |
| `get_post` | One post as Markdown, by slug or URL |
| `list_posts` | Newest first, filtered by series, tag or category |
| `list_series` | Multi-part series with slugs and post counts |

## Try it without a client

```bash
curl -s https://mcp.vanducng.dev/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
       "params": {"name": "search_posts", "arguments": {"query": "airflow"}}}'
```