Tim Benniks developer resources.

Search the content · REST

curl -s 'https://timbenniks.dev/api/v1/search?query=composable&limit=2'

# 200 application/json
# { "results": [ { "type": "writing",
#                  "title": "Ten AI security problems hiding in plain text",
#                  "date": "2026-08-05", "description": "…", "tags": [ … ],
#                  "url": "https://timbenniks.dev/writing/<slug>",
#                  "md": "https://timbenniks.dev/writing/<slug>.md",
#                  "source": "…" } ],
#   "engine": "index" }

List the tools · MCP handshake

# 1. Initialize; use the returned protocolVersion below.
curl -s https://timbenniks.dev/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# 2. Confirm initialization (202, empty body).
curl -s https://timbenniks.dev/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d '{"jsonrpc":"2.0","method":"notifications/initialized"}'

# 3. List the six read-only tools (200, JSON result).
curl -s https://timbenniks.dev/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

# No session ID is required. GET with Accept: text/event-stream
# returns 405: this server sends immediate JSON responses.

Read a page as markdown

curl -s https://timbenniks.dev/about.md
curl -s -H 'Accept: text/markdown' https://timbenniks.dev/about

# 200 text/markdown; charset=utf-8
# Vary: Accept, Accept-Encoding
# Same twin for /writing/<slug>.md, /videos/<slug>.md, /projects/<slug>.md.

What failure looks like

curl -si 'https://timbenniks.dev/api/v1/search'   # query is required

# 400 application/problem+json; charset=utf-8
# api-version: 1
# ratelimit: "public";r=118;t=60
# ratelimit-policy: "public";q=120;w=60
# { "type": "https://timbenniks.dev/developers#missing-query",
#   "title": "Search query required", "status": 400,
#   "detail": "The query parameter is required and must not be empty.",
#   "instance": "/api/v1/search", "code": "MISSING_QUERY",
#   "resolution": "Retry with a URL such as /api/v1/search?query=developer%20experience." }
#
# 429 once you pass 120 requests / 60s, read RateLimit and Retry-After to back off.