MCP.so
Sign In

esa-mcp-server

@d-kimuson

Repository

About esa-mcp-server

esa の Model Context Protocol サーバー実装

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "esa-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "esa-mcp-server@latest"
      ],
      "env": {
        "ESA_API_KEY": "your api key here",
        "DEFAULT_ESA_TEAM": "your default esa team"
      }
    }
  }
}

Tools

7

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.

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.

Read a post in esa.io.

Read multiple posts in esa.io.

Create a new post in esa.io. Required parameters: name. Optional parameters: body_md, tags, category, wip (default: true), message.

Update an existing post in esa.io. Required parameters: postNumber. Optional parameters: name, body_md, tags, category, wip, message.

Delete a post in esa.io. Required parameters: postNumber.

Overview

What is esa-mcp-server?

esa-mcp-server is a server that exposes the esa.io API through the Model Context Protocol (MCP), enabling AI assistants to search, read, create, update, and delete esa.io articles. It is designed for users of esa.io who want to integrate these operations via MCP with a lightweight footprint.

How to use esa-mcp-server?

Configure your MCP client to run npx -y esa-mcp-server@latest and set the environment variables ESA_API_KEY and DEFAULT_ESA_TEAM. Once configured, the server’s tools become available for your AI assistant to call.

Key features of esa-mcp-server

  • Search articles with search_esa_posts
  • Read single or multiple articles
  • Create, update, and delete articles
  • Provides query syntax documentation via get_search_query_document
  • Compact design (system prompt ~3.4k tokens)

Use cases of esa-mcp-server

  • AI assistant searching for relevant esa.io articles
  • Automating creation of new articles based on prompts
  • Updating existing article content programmatically
  • Reading multiple articles to gather information
  • Deleting outdated or duplicate articles

FAQ from esa-mcp-server

What is the difference between this server and the official esa MCP server?

The official server is more feature‑rich but has a larger system prompt (~11.3k tokens). This server is limited to article operations but is more compact (~3.4k tokens), making it easier to use when context window is limited.

What environment variables are required?

You must provide ESA_API_KEY (your esa.io API key) and DEFAULT_ESA_TEAM (your default esa team name).

How do I install and configure esa-mcp-server?

Add the server to your MCP client settings using the npx command shown in the README, along with the required environment variables. No additional installation steps are needed.

What tools are provided?

The server offers: search_esa_posts, read_esa_post, read_esa_multiple_posts, create_esa_post, update_esa_post, delete_esa_post, and get_search_query_document.

Is this server recommended for all use cases?

The official esa MCP server is recommended when full feature set is needed. This server is a good choice when the official server’s context usage is too high or when you only need article operations.

Frequently asked questions

What is the difference between this server and the official esa MCP server?

The official server is more feature‑rich but has a larger system prompt (~11.3k tokens). This server is limited to article operations but is more compact (~3.4k tokens), making it easier to use when context window is limited.

What environment variables are required?

You must provide `ESA_API_KEY` (your esa.io API key) and `DEFAULT_ESA_TEAM` (your default esa team name).

How do I install and configure esa-mcp-server?

Add the server to your MCP client settings using the `npx` command shown in the README, along with the required environment variables. No additional installation steps are needed.

What tools are provided?

The server offers: `search_esa_posts`, `read_esa_post`, `read_esa_multiple_posts`, `create_esa_post`, `update_esa_post`, `delete_esa_post`, and `get_search_query_document`.

Is this server recommended for all use cases?

The official esa MCP server is recommended when full feature set is needed. This server is a good choice when the official server’s context usage is too high or when you only need article operations.

Comments

Basic information

Category

Other

License

MIT

Transports

stdio

Author

d-kimuson

More Other MCP servers

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

IDA Pro MCP

mrexodia

AI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.

9.9K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K