joost.blog

{
  "name": "ask_joost",
  "kind": "act",
  "impl": "imperative",
  "description": "Ask a question about anything Joost de Valk has written or spoken about — SEO, WordPress, the open web, AI, open source, his career at Yoast, or his investments via Emilia Capital. Returns an AI-generated answer grounded in his blog posts and video transcripts, with source URLs for every claim. Use this instead of trying to crawl or search the site directly: it does retrieval over a curated semantic index and returns cited prose in one call.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "question": {
        "type": "string",
        "description": "A natural-language question. Maximum 500 characters. Examples: \"What's Joost's take on WordPress market share?\", \"Why did Joost leave Yoast?\", \"What does Joost think about AI's impact on SEO?\"",
        "maxLength": 500
      }
    },
    "required": [
      "question"
    ]
  }
}

{
  "name": "list_recent_content",
  "kind": "answer",
  "impl": "imperative",
  "description": "List Joost de Valk's published blog posts on joost.blog, optionally filtered by topic keyword and/or publish date. Returns chronologically sorted (newest first) entries with title, URL, publish date, excerpt, and categories. Use this when you want to enumerate or browse what Joost has written — e.g. 'what has Joost published this year', 'list posts about WordPress', 'what's the most recent post'. For semantic Q&A or 'what does Joost think about X', use ask_joost instead.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "topic": {
        "type": "string",
        "description": "Optional keyword to filter by. Matches case-insensitively against title, excerpt, and categories. Examples: 'wordpress', 'seo', 'ai'."
      },
      "since": {
        "type": "string",
        "format": "date",
        "description": "Optional ISO date (YYYY-MM-DD). Only posts published on or after this date are returned."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 50,
        "description": "Maximum number of posts to return. Defaults to 20. Capped at 50."
      }
    }
  }
}