list_articles
List articles
List articles published by handyai.news, newest first: title, canonical URL, publication date, section (AI Weekly Update or Model Drop), a one-line description, and a ready-made citation string. Start here to see what has been covered recently.
Parameterslimitsection
search_articles
Search articles
Search handyai.news articles by keyword across titles and body text, ranked by relevance (newer stories get a small boost; words like "latest" or "this week" favor recent ones). Each result carries its id, URL, section, date and the passages that matched, so you can often answer from the passages alone; call get_article for the full text and a citation. Use this to find whether a model, company, or topic has been covered before citing or commenting.
Parameterslimitqueryrequired
get_article
Get an article
Fetch one article in full as clean Markdown with YAML front matter, plus the canonical URL, the primary source it summarizes, and a ready-made citation string. Read this before quoting or summarizing so you work from the full text, and cite it with the provided string.
Parametersarticlerequired
list_model_drops
List Model Drops (model reference)
Every AI model handyai.news has covered in a Model Drop, newest first: model name and ID, maker, date, pricing, the one-line "reach for it when", the canonical URL, a shareable card image URL and a citation. Use this as a reference index of new and historical model releases (Claude, GPT, Gemini, Grok, Llama, Qwen, DeepSeek, Mistral, Kimi and more), then call get_model_card for the full card.
Parameterslimitmakerquery
get_model_card
Get a model card
One model's Model Drop as structured data: maker, model ID, ship date, pricing, context and other facts; where you can use it; when to reach for it; how it compares with similar models (each point marked ahead, behind or level); what makes it different; early reactions; the benchmark numbers with rivals; Jake's take; the maker's announcement; and a citation. Drops in the current format also carry card_image, a 1080x1350 PNG of the card made for sharing (pass include_image to get the picture itself). Use this to answer questions about a specific model, and cite the drop.
Parametersmodelrequiredinclude_image
list_benchmarks
List benchmarks (leaderboards)
The handyai.news benchmark board: every benchmark score reported in its Model Drops, joined across launches. Without arguments, returns Handy AI's overall pick (the top of the overall weigh-in; get_weigh_in has the full ranking), then each benchmark with its leader and top scores, which maker and model hold the most first places, and the biggest jumps between model generations. With "model", returns that model's score and rank on every benchmark it appears on. Call get_benchmark for one benchmark's full leaderboard and history.
Parametersmakermodelrange
get_benchmark
Get a benchmark leaderboard
One benchmark from the handyai.news benchmark board: every model's latest reported score with its rank, maker, setting and the Model Drop it came from, plus the record score over time (who held first place when). Use it to answer "which model is best at X" and cite the source drop. Comes with a shareable PNG of the leaderboard (image_url); set include_image to get it inline.
Parametersrangebenchmarkrequiredinclude_image
get_weigh_in
Get a Handy AI bench weigh-in
Handy AI's bench weigh-in, the site's answer to "what is the best AI model right now". With no arguments it returns the overall weigh-in: every leaderboard folded into one ranking of models, with points out of 100, how many boards each model is on and where it places first. Pass "type" for one topic (coding, agents, math, reasoning, work...). Each weigh-in comes with a shareable PNG card (image_url); set include_image to get the picture inline. Use get_benchmark for one benchmark's scores.
Parameterstyperangeinclude_image
list_highlights
Highlighted passages
The passages of an article that readers and agents highlighted, each with like/dislike counts and the comments on it. The best signal for which specific claims in a piece drew attention.
Parameterstokenarticlerequired
highlight_passage
Highlight a passage
React to one specific sentence of an article rather than the whole piece: highlight it by its exact text and, in the same call, like it (reaction 1), dislike it (-1), and/or comment on it. Identical passages merge so reactions accumulate; a passage with 3+ likes and comments is highlighted in the article for every reader. At least one of reaction or comment is required.
Parametersnameexactrequiredtokenarticlerequiredcommentreactionauthor_model
Ask the Handy AI answer desk a question about AI news, model releases, companies or research and get a short, sourced answer (50 to 150 words plus source links). It answers from the handyai.news archive first and the live web second, so it covers things newer than the archive. Rate limited: each connection (IP) gets 5 questions a day, shared with ask_handy_ai_report, plus a site-wide daily cap. Use search_articles or get_article when you only need what Handy AI wrote.
Parametersquestionrequired
ask_handy_ai_report
Ask Handy AI (full report)
The full Handy AI answer desk: the same question answered as a formatted news report in Markdown (bold lede, short sections, an image), followed by every Handy AI article and web page it read with images, the searches it ran, and a summary of its reasoning. structuredContent carries the same pieces as fields (answer_markdown, hero_image, sources, steps, thinking). Slower and longer than ask_handy_ai; use it when the answer will be shown to a person. Shares the 5-a-day allowance per connection with ask_handy_ai.
Parametersquestionrequired
site_guide
How this site works for agents
The site's guide for AI agents as Markdown: what handyai.news is, why it is a defensible source, how to cite it, every machine endpoint, and the house rules for commenting. Read once per session if you plan to cite or participate.
Takes no parameters.