esa-mcp-server

koki-develop/esa-mcp-server

3.2

If you are the rightful owner of esa-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The esa MCP Server is a Model Context Protocol server designed for integration with the esa.io platform, providing tools for managing posts, tags, and comments.

Tools

  1. get_posts

    Retrieve a list of posts from the esa team with support for search queries, filtering, sorting, and pagination.

  2. get_post

    Retrieve a specific post by post number, including complete details and optional nested inclusion of comments and stargazers.

  3. create_post

    Create a new post with a title, content, tags, and other metadata.

  4. update_post

    Update an existing post with new content, tags, and other metadata.

  5. delete_post

    Permanently delete a post by post number.

  6. get_tags

    Get a list of all tags used in the esa team, sorted by post count.

  7. get_post_comments

    Retrieve a list of comments for a specific post, with support for pagination.

  8. create_post_comment

    Create a new comment on an existing post with content in Markdown format.

  9. update_comment

    Update an existing comment with new content in Markdown format.

  10. delete_comment

    Permanently delete a comment by comment ID.

esa MCP Server

Version Docker

A Model Context Protocol (MCP) server for esa.io.

Table of Contents

Usage

Prerequisites

Before using this MCP server, you need to generate a personal access token from your esa.io team:

  1. Go to https://<TEAM_NAME>.esa.io/user/applications
  2. Create a new personal access token
  3. Copy the token for configuration

Configuration

To use this server with an MCP client, add the following configuration:

{
  "mcpServers": {
    "esa": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_TEAM=<your-team-name>",
        "-e",
        "ESA_ACCESS_TOKEN=<your-personal-access-token>",
        "ghcr.io/koki-develop/esa-mcp-server:latest"
      ]
    }
  }
}

Replace <your-team-name> and <your-personal-access-token> with your team name and personal access token.

Read-only Mode

To enable read-only mode that only allows read operations, add the --readonly flag:

{
  "mcpServers": {
    "esa-readonly": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ESA_TEAM=<your-team-name>",
        "-e",
        "ESA_ACCESS_TOKEN=<your-personal-access-token>",
        "ghcr.io/koki-develop/esa-mcp-server:latest",
        "--readonly"
      ]
    }
  }
}

In read-only mode, only the following operations are available:

  • get_posts - retrieve posts
  • get_post - retrieve a specific post
  • get_tags - retrieve tags
  • get_post_comments - retrieve post comments

Write operations (create_post, update_post, delete_post, create_post_comment, update_comment, delete_comment) are disabled.

MCP Tools

Posts

ToolDescription
get_postsRetrieve 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'.
get_postRetrieve 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_postCreate 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_postUpdate 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_postDelete 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.

Tags

ToolDescription
get_tagsGet 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.

Comments

ToolDescription
get_post_commentsRetrieve 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_commentCreate 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_commentUpdate 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_commentDelete 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.

License

This project is licensed under the MIT License - see the file for details.

Copyright (c) 2025 Koki Sato