A Model Context Protocol (MCP) server for esa.io API integration. Enables Claude Desktop and other MCP clients to interact with esa.io teams, posts, comments, and members.

# Clone the repository
git clone https://github.com/iberianpig/mcp_esa.git
cd mcp_esa

# Make the script executable
chmod +x mcp_esa.rb

# Download the single file
curl -O https://raw.githubusercontent.com/iberianpig/mcp_esa/main/mcp_esa.rb
chmod +x mcp_esa.rb

export ESA_ACCESS_TOKEN="your_token_here"
export ESA_TEAM_NAME="your_team_name"

Add to your .mcp.json:

{
  "mcpServers": {
    "esa": {
      "command": "ruby",
      "args": ["/path/to/mcp_esa/mcp_esa.rb"]
    }
  }
}

Show me the latest posts from esa.io

Create a new post titled "Meeting Notes"

Show comments for post #123

echo '{"jsonrpc":"2.0","id":0,"method":"tools/list"}' | ./mcp_esa.rb

list posts with filtering and pagination:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_posts_tool","arguments":{}}}' | ./mcp_esa.rb

Posts

• get_posts_tool - List posts with filtering and pagination
• get_post_tool - Get detailed post information
• create_post_tool - Create new posts
• update_post_tool - Update existing posts

Teams

• get_teams - List teams you belong to
• get_team - Get team details
• get_members - List team members

Comments

• get_comments - List comments for a post
• create_comment - Add new comments