Docs · Concepts
WebMCP tools reference
Every tool the agentprose script registers for AI agents, what it returns, and its inputs.
These are the tools an AI agent sees on a page with the agentprose script. All built-in tools are read-only and mark post text as untrusted content. Long answers are paged: they stop at max_chars (default 20,000) and return a next_offset to continue.
| Tool | What it returns |
|---|---|
get_current_article |
The post being viewed as clean Markdown, with title, authors, dates, tags, reading time and section outline |
search_posts |
Ranked full-text search across the whole site, with filters |
list_posts |
Newest or oldest posts, filterable and paginated |
get_post |
Any post as Markdown by URL or slug, optionally one section |
get_table_of_contents |
The heading outline of a post |
get_section |
One section's Markdown, matched by id or heading text |
get_related_posts |
Posts related by shared tags, categories and topic |
list_taxonomies |
Tags, categories and authors, with post counts |
get_citation |
A formatted citation; with quote it checks the text appears and returns a link that highlights it |
get_site_info |
Site name, description, language, feeds, post count and latest post |
get_subscribe_link, get_comments_link, navigate_to |
Opt-in actions you turn on in the script tag |
Inputs
search_posts: query (required), limit (1–50, default 10), tag, category, author, since, until (ISO dates).
list_posts: limit (1–100, default 20), offset, sort (newest or oldest), tag, category, author, since, until.
get_post: url or slug, optional section, max_chars, offset.
get_current_article: max_chars, offset.
get_table_of_contents: url or slug.
get_section: section (required; id or heading text), url or slug.
get_related_posts: url or slug, limit (1–20, default 5).
list_taxonomies: type (all, tags, categories or authors), limit.
get_citation: url or slug, optional quote.
With agentprose Cloud
With a site key, search_posts answers from your hosted index (fast, the whole archive, semantic on Team). Over your monthly search quota it falls back to the script's own search in the browser, so agents always get an answer. Every call is counted in your dashboard. Post content is never sent to us.
The complete schemas are in the library's tools reference.