Most wiki integrations hand you a query box and let you guess; this one returns the operator set first, so a search can be scoped by title, WIP state, kind or category rather than hoping keyword matching lands on the right document. The write side is complete — create, update, delete — and create_esa_post defaults wip to true, so a draft written by an agent does not publish itself. read_esa_multiple_posts is the round-trip saver when a search turns up several things worth reading.
A read-and-write server over an esa.io team's posts, plus a tool that returns the search query language itself.
- get_search_query_document, which returns the esa.io query syntax: available operators, parameters and what each matches
- Post search with that syntax — exact phrases, AND and OR, exclusion, title:, wip:, kind: and category: — plus page, perPage, sort and order
- One post read by postNumber, or several at once through read_esa_multiple_posts
- Post creation taking body_md, tags, category, a change message, and wip, which defaults to true
- Post updates across the same fields, and deletion by postNumber
- A teamName argument on every post tool, so a second team is reachable without reconfiguring
An esa.io API key in ESA_API_KEY and a default team name in DEFAULT_ESA_TEAM.
One command plus a key — npx -y esa-mcp-server@latest, then supply credentials