A Model Context Protocol (MCP) server for esa.io
Valid MCP server (3 strong, 4 medium validity signals). 4 known CVEs in dependencies (0 critical, 4 high severity) Package registry verified. Imported from the Official MCP Registry.
8 files analyzed · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: ESA_TEAM
Environment variable: ESA_ACCESS_TOKEN
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-koki-develop-esa-mcp-server": {
"env": {
"ESA_TEAM": "your-esa-team-here",
"ESA_ACCESS_TOKEN": "your-esa-access-token-here"
},
"args": [
"-y",
"@koki-develop/esa-mcp-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
[!IMPORTANT] An official MCP server has been released. Please use the official server going forward.
A Model Context Protocol (MCP) server for esa.io.
Before using this MCP server, you need to generate a personal access token from your esa.io team:
https://<TEAM_NAME>.esa.io/user/applicationsYou can run the server either via npx or Docker.
Add the following configuration to your MCP client:
{
"mcpServers": {
"esa": {
"command": "npx",
"args": [
"-y",
"@koki-develop/esa-mcp-server@latest"
],
"env": {
"ESA_TEAM": "<your-team-name>",
"ESA_ACCESS_TOKEN": "<your-personal-access-token>"
}
}
}
}
Replace <your-team-name> and <your-personal-access-token> with your team name and personal access token.
If you prefer Docker, use the following configuration:
{
"mcpServers": {
"esa": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ESA_TEAM",
"-e",
"ESA_ACCESS_TOKEN",
"ghcr.io/koki-develop/esa-mcp-server:latest"
],
"env": {
"ESA_TEAM": "<your-team-name>",
"ESA_ACCESS_TOKEN": "<your-personal-access-token>"
}
}
}
}
To enable read-only mode that only allows read operations, add the --readonly flag.
Using npx:
{
"mcpServers": {
"esa": {
"command": "npx",
"args": [
"-y",
"@koki-develop/esa-mcp-server@latest",
"--readonly"
],
"env": {
"ESA_TEAM": "<your-team-name>",
"ESA_ACCESS_TOKEN": "<your-personal-access-token>"
}
}
}
}
Using Docker:
{
"mcpServers": {
"esa": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ESA_TEAM",
"-e",
"ESA_ACCESS_TOKEN",
"ghcr.io/koki-develop/esa-mcp-server:latest",
"--readonly"
],
"env": {
"ESA_TEAM": "<your-team-name>",
"ESA_ACCESS_TOKEN": "<your-personal-access-token>"
}
}
}
}
In read-only mode, only the following operations are available:
get_posts - retrieve postsget_post - retrieve a specific postget_tags - retrieve tagsget_post_comments - retrieve post commentsWrite operations (create_post, update_post, delete_post, create_post_comment, update_comment, delete_comment) are disabled.
| Tool | Description |
|---|---|
get_posts | Retrieve a list of posts from the esa team. Supports search queries, filtering, sorting, and pagination. Returns post metadata including title, content, tags, categories, author information, and engagement metrics (comments, stars, watches). Optionally includes comments and stargazers with the include parameter. Supports nested inclusion like 'comments,comments.stargazers'. Note: Post content (body_md) is truncated to 300 characters with a body_truncated field indicating if truncation occurred to reduce context size. |
get_post | Retrieve a specific post from the esa team by post number. Returns complete post details including title, content (markdown), tags, category, author information, revision history, and engagement metrics. Optionally includes comments and stargazers. Supports nested inclusion like 'comments,comments.stargazers'. |
create_post | Create a new post in the esa team. Requires a title and optionally accepts content, tags, category, WIP status, and other metadata. Returns the created post information including the assigned post number and URL. |
update_post | Update an existing post in the esa team. Requires a post number and optionally accepts updated content, tags, category, WIP status, and other metadata. Returns the updated post information including revision details. |
delete_post | Delete an existing post from the esa team. Requires a post number. The post will be permanently deleted and cannot be recovered. Returns a confirmation message upon successful deletion. |
| Tool | Description |
|---|---|
get_tags | Get a list of all tags used in the esa team. Returns tags with their names and the number of posts they are attached to, sorted by post count in descending order. Supports pagination. |
| Tool | Description |
|---|---|
get_post_comments | Retrieve a list of comments for a specific post from the esa team. Requires a post number and supports pagination. Returns comment metadata including content, author information, timestamps, and engagement metrics (stars). |
create_post_comment | Create a new comment on an existing post in the esa team. Requires a post number and comment content in Markdown format. Returns the created comment information including ID, content, timestamps, and author details. |
update_comment | Update an existing comment on a post in the esa team. Requires a comment ID and new content in Markdown format. Returns the updated comment information including content, timestamps, and author details. |
delete_comment | Delete an existing comment from the esa team. Requires a comment ID. The comment will be permanently deleted and cannot be recovered. Returns a confirmation message upon successful deletion. |
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 Koki Sato
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.