Esa.io Search
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
What is Esa.io Search?
Esa.io Search is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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
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
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- html_deploy
- routine_create
- routine_delete
- routine_list
- routine_get
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @esaio/esa-mcp-serverManual Installation
npx -y @esaio/esa-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Esa.io Search
The esa MCP Server connects AI assistants to esa.io, the team knowledge-base platform popular among engineering and documentation teams in Japan. It exposes over 30 tools covering article search, creation, updating, archiving, commenting, category browsing, and attachment retrieval — giving Claude direct read/write access to your team's esa workspace. Engineers use it to quickly find internal documentation, create new posts, and manage the full lifecycle of team knowledge without leaving their AI chat interface.
Prerequisites
- An esa.io team account with a personal access token (PAT v2 recommended, with read:post, write:post, and read:team scopes)
- Docker installed (recommended) OR Node.js 18+ for npx usage
- Claude Desktop or another MCP-compatible AI client
- Your esa.io team name (the subdomain used to access your team, e.g. 'myteam' from myteam.esa.io)
Generate an esa.io personal access token
Log into your esa.io team, go to Settings > Applications > Personal access tokens, and create a new token. Grant it at minimum read:post and write:post scopes. Copy the token immediately as it won't be shown again.
Pull the Docker image (recommended method)
Pull the official Docker image from GitHub Container Registry. This is the recommended installation method as it requires no local Node.js setup.
docker pull ghcr.io/esaio/esa-mcp-serverTest the server connection
Verify your token and server work by running the container interactively. Replace 'your_token' with your actual ESA_ACCESS_TOKEN.
ESA_ACCESS_TOKEN=your_token docker run -i --rm -e ESA_ACCESS_TOKEN ghcr.io/esaio/esa-mcp-serverConfigure Claude Desktop
Add the esa MCP Server to your Claude Desktop configuration. Set ESA_ACCESS_TOKEN to your personal access token and LANG to your preferred language code.
{
"mcpServers": {
"esa": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "ESA_ACCESS_TOKEN", "-e", "LANG", "ghcr.io/esaio/esa-mcp-server"],
"env": {
"ESA_ACCESS_TOKEN": "your_esa_personal_access_token",
"LANG": "ja"
}
}
}
}Restart Claude Desktop and start searching
Restart Claude Desktop to load the esa tools. Claude can now search posts using esa's query syntax, including keyword, 'exact phrase', book:category, and tag:name qualifiers.
Esa.io Search Examples
Client configuration
Claude Desktop configuration using the official Docker image for esa MCP Server.
{
"mcpServers": {
"esa": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "ESA_ACCESS_TOKEN",
"-e", "LANG",
"ghcr.io/esaio/esa-mcp-server"
],
"env": {
"ESA_ACCESS_TOKEN": "your_personal_access_token",
"LANG": "ja"
}
}
}
}Prompts to try
Example prompts for searching and managing esa.io posts through Claude.
- "Search for posts about 'deployment' in esa"
- "Find all posts with the tag 'onboarding' in esa"
- "Create a new esa post titled 'Sprint 42 Retrospective' in the Engineering category"
- "Show me the most recent posts in esa"
- "Summarize the post about our release process in esa"
- "List all comments on the post about API design guidelines"Troubleshooting Esa.io Search
401 Unauthorized error when starting the server
Your ESA_ACCESS_TOKEN is invalid or expired. Go to esa.io Settings > Applications > Personal access tokens, revoke the old token, and create a new one with the required scopes (read:post, write:post, read:team). Update the token in your Claude Desktop config.
Docker container exits immediately with no output
Ensure you are running Docker with the -i (interactive) flag so stdin remains open for MCP stdio communication. The full command must include both -i and --rm flags: docker run -i --rm -e ESA_ACCESS_TOKEN ...
Search returns no results even though posts exist
Check your search query syntax. Use single quotes for exact phrase matching ('keyword'), space-separated terms for AND logic, and qualifiers like book:category-name or tag:tagname. Also verify the personal access token has read:post scope.
Frequently Asked Questions about Esa.io Search
What is Esa.io Search?
Esa.io Search is a Model Context Protocol (MCP) server that 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 It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Esa.io Search?
Install via npm with the command: npx -y @esaio/esa-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Esa.io Search?
Esa.io Search works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Esa.io Search free to use?
Yes, Esa.io Search is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Esa.io Search Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Esa.io Search? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Esa.io Search in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Esa.io Search?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.