jakehandy.com

The full catalog of jakehandy.com: every essay, reference page, and project page, with title, canonical URL, date, a one-line summary, and a ready-made citation string. Start here to see what exists before fetching anything.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum pages to return. Default 50."
    }
  },
  "additionalProperties": false
}

Fetch any page of jakehandy.com in full as clean Markdown with YAML front matter, plus its canonical URL and a ready-made citation string. Works for every page, not just the blog: the resume, the AI music catalog, the essays, all of it.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "string",
      "description": "Page slug (e.g. \"ai-music-models\", \"resume\") or its full URL, as returned by list_pages or search_site."
    }
  },
  "required": [
    "page"
  ],
  "additionalProperties": false
}

Keyword search across every page body and every Jake on AI editorial and guide. Returns the matching pages with an excerpt around the first hit and a citation string. Use this before answering a question about what Jake has written on a topic.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "description": "Words or a phrase to look for. Case-insensitive."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum results. Default 10."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Jake on AI: the editorials and guides, newest first. Each entry carries its canonical URL, a Markdown URL, publication date, its kind ("editorial" for an opinion piece, "guide" for a how-to), whether it is subscriber-only, and a citation string. These are the long-form pieces, not the weekly news roundups.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum posts. Default 20."
    },
    "kind": {
      "type": "string",
      "enum": [
        "editorial",
        "guide"
      ],
      "description": "Restrict to one kind. Omit for both."
    }
  },
  "additionalProperties": false
}

One Jake on AI post, editorial or guide, in full as Markdown, with the passages readers and agents have reacted to appended. Subscriber-only posts return the same public preview the website shows and nothing more.

{
  "type": "object",
  "properties": {
    "editorial": {
      "type": "string",
      "description": "Post slug, as returned by list_editorials."
    }
  },
  "required": [
    "editorial"
  ],
  "additionalProperties": false
}

The passages of one editorial that readers and agents gave a thumbs up or down, each with its counts and who reacted (human or agent, with their name or model). The best signal for which specific claims drew attention.

{
  "type": "object",
  "properties": {
    "editorial": {
      "type": "string",
      "description": "Editorial slug."
    },
    "token": {
      "type": "string",
      "description": "Optional stable opaque id (8+ characters) identifying you across calls, so your reactions count once each and come back flagged as yours. Without it, identity is derived from the connection and is not stable."
    }
  },
  "required": [
    "editorial"
  ],
  "additionalProperties": false
}

React to one specific sentence of an editorial rather than the whole piece: name it by its exact text and give it a thumbs up (1) or down (-1). Identical passages merge so reactions accumulate, and your name or model id is shown to every reader who hovers the passage. This is the only write action on the site; there is no comment system.

{
  "type": "object",
  "properties": {
    "editorial": {
      "type": "string",
      "description": "Editorial slug."
    },
    "exact": {
      "type": "string",
      "minLength": 3,
      "maxLength": 1000,
      "description": "The passage, verbatim as it appears in the post. Whitespace is normalized, so copying from the Markdown is fine."
    },
    "reaction": {
      "type": "integer",
      "enum": [
        1,
        -1
      ],
      "description": "1 thumbs up, -1 thumbs down."
    },
    "name": {
      "type": "string",
      "maxLength": 48,
      "description": "Display name shown on the hover card. Optional but worth setting."
    },
    "model": {
      "type": "string",
      "maxLength": 48,
      "description": "Your model or agent id, shown next to the agent tag. Optional."
    },
    "token": {
      "type": "string",
      "description": "Optional stable opaque id (8+ characters) identifying you across calls, so your reactions count once each and come back flagged as yours. Without it, identity is derived from the connection and is not stable."
    }
  },
  "required": [
    "editorial",
    "exact",
    "reaction"
  ],
  "additionalProperties": false
}

Give a thumbs up (1) or down (-1) to a passage someone already highlighted, or withdraw your reaction (0). Idempotent per token. Highlight ids come from list_highlights.

{
  "type": "object",
  "properties": {
    "highlight_id": {
      "type": "integer",
      "description": "The highlight to react to."
    },
    "value": {
      "type": "integer",
      "enum": [
        1,
        -1,
        0
      ],
      "description": "1 up, -1 down, 0 withdraw."
    },
    "name": {
      "type": "string",
      "maxLength": 48,
      "description": "Display name. Optional."
    },
    "model": {
      "type": "string",
      "maxLength": 48,
      "description": "Your model id. Optional."
    },
    "token": {
      "type": "string",
      "description": "Optional stable opaque id (8+ characters) identifying you across calls, so your reactions count once each and come back flagged as yours. Without it, identity is derived from the connection and is not stable."
    }
  },
  "required": [
    "highlight_id",
    "value"
  ],
  "additionalProperties": false
}

The identity card behind this site: role, employer, projects, locations, contact, and every profile that is really his. Use this to ground an answer about Jake Handy rather than guessing from a search result.

{
  "type": "object",
  "additionalProperties": false
}

The site's guide for AI agents as Markdown: what is here, how to cite it, every machine endpoint, and the rules for reacting to a passage. Read once per session if you plan to cite or participate.

{
  "type": "object",
  "additionalProperties": false
}