create_esa_post
Create a new post in esa.io. Required parameters: name. Optional parameters: body_md, tags, category, wip (default: true), message.
LABSCO SUMMARY
The syntax tool is what makes the search worth running.
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.
What it is
A read-and-write server over an esa.io team's posts, plus a tool that returns the search query language itself.
What you get
- 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
Requirements
An esa.io API key in ESA_API_KEY and a default team name in DEFAULT_ESA_TEAM.
Setup effort
One command plus a key — npx -y esa-mcp-server@latest, then supply credentials
USE CASES
01
Finding the doc that already answers the question
Fetch the query syntax first so the filter is composed from real operators — exact phrases, exclusions, title: and wip: — then search the team and read the post that matches.
02
Pulling several scattered docs into one answer
When the answer lives across a handful of posts, search for the set and read them together in a single call rather than one round trip per post.
03
Filing meeting notes the team can pick up later
Create the post with a category and tags; wip defaults to true, so it arrives as work-in-progress. Publishing is a later update with a message that explains what changed.
04
Clearing out a doc nobody should follow any more
Read the post to see what it still claims, either update it with a message saying what replaced it, or delete it by number when it should not survive at all.
7 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
delete_esa_post
Delete a post in esa.io. Required parameters: postNumber.
get_search_query_document
Retrieves comprehensive documentation about esa.io search queries. Provides detailed information about available query syntax, operators, and search parameters to effectively search through esa posts.
read_esa_multiple_posts
Read multiple posts in esa.io.
read_esa_post
Read a post in esa.io.
search_esa_posts
Search posts in esa.io. Response is paginated. For efficient search, you can use customized queries like the following: keyword for partial match, "keyword" for exact match, keyword1 keyword2 for AND match, keyword1 OR keyword2 for OR match, -keyword for excluding keywords, title:keyword for title match, wip:true or wip:false for WIP posts, kind:stock or kind:flow for kind match, category:category_name for partial match with category name, in:category_name for prefix match with category name, on:category_name for exact match with category name, body:keyword for body match, tag:tag_name or tag:tag_name case_sensitive:true for tag match, user:screen_name for post author's screen name, updated_by:screen_name for post updater's screen name, comment:keyword for partial match with comments, starred:true or starred:false for starred posts, watched:true or watched:false for watched posts, watched_by:screen_name for screen name of members watching the post, sharing:true or sharing:false for shared posts, stars:>3 for posts with more than 3 stars, watches:>3 for posts with more than 3 watches, comments:>3 for posts with more than 3 comments, done:>=3 for posts with 3 or more done items, undone:>=3 for posts with 3 or more undone items, created:>YYYY-MM-DD for filtering by creation date, updated:>YYYY-MM-DD for filtering by update date.Strongly recommend see get_search_query_document for complete query usage.
update_esa_post
Update an existing post in esa.io. Required parameters: postNumber. Optional parameters: name, body_md, tags, category, wip, message.
BEFORE YOU INSTALL
What to know first
Tools you get
7 tools when we connected.
Requires
- npx on PATH
- ESA_API_KEY in your environment
CONTEXT COST
Light Standing cost
Rated by the size of the 7 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"esa-mcp-server": {
"command": "npx",
"args": [
"-y",
"esa-mcp-server@latest"
],
"env": {
"ESA_API_KEY": "<YOUR_ESA_API_KEY>",
"DEFAULT_ESA_TEAM": "<YOUR_DEFAULT_ESA_TEAM>"
}
}
}
}npx
TERMINAL
npx -y esa-mcp-server@latest
