What is esa-mcp-server CLAUDE.md?

A set of Claude Code instructions for esa-mcp-server, an MCP server that lets AI clients such as Claude Desktop or Cody use the esa.io information-sharing service.

Use it when installing dependencies, building, type-checking, linting, formatting, inspecting, or extending the esa.io MCP server.

It collects the project’s setup, build, checking, formatting, testing, and architecture instructions in one place.

esa-mcp-server CLAUDE.md — Instructions file for coding agents by koki-develop: A set of Claude Code instructions for esa-mcp-server, an…

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods

npx agentmods add instructions/koki-develop/esa-mcp-server/claude-md

Clone the repo

git clone --depth 1 https://github.com/koki-develop/esa-mcp-server

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/instructions/koki-develop/esa-mcp-server/claude-md.svg)](https://agentmods.dev/instructions/koki-develop/esa-mcp-server/claude-md)

Your own site

<a href="https://agentmods.dev/instructions/koki-develop/esa-mcp-server/claude-md"><img src="https://agentmods.dev/badge/instructions/koki-develop/esa-mcp-server/claude-md.svg" alt="Measured on agentmods" height="20"></a>

Per session 705 This file is loaded in full into every session.

When invoked 705 The same file — it is already loaded in full.

Security scan A 0 findings. Scan, not verified.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5	$0.00705	$0.00705
Opus 5	$0.00352	$0.00352
Sonnet 5	$0.00141	$0.00141
Haiku 4.5	$0.00071	$0.00071

Measured 4d ago against content hash 0c61b739b714, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

esa-mcp-server CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 90 lines

How it starts

The opening of the file, as written. The whole thing — 90 lines — stays where its author put it; the contents beside it link to each section on GitHub.

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is an MCP (Model Context Protocol) server for esa.io (information sharing service). It enables MCP clients (like Claude Desktop or Cody) to interact with esa.io's API.

Development Commands

Build, Type Check, and Lint

# Build the project (outputs to dist/)
bun run build

# TypeScript type checking
bun run typecheck

# Check code with Biome
bun run lint

# Auto-fix code with Biome
bun run fmt

Testing

# Run MCP Inspector for manual testing
bun run inspector

Dependency Management

# Install dependencies
bun install

# Add dependencies
bun add <package-name>
bun add -D <package-name>  # Development dependencies

Architecture

Directory Structure

src/index.ts - Entry point (runs MCP protocol via stdio)
src/server.ts - MCP server implementation (server name, tool registration)
src/mcp/tools/ - MCP tool definitions (implement each tool here)
src/lib/esa/ - esa.io API client implementation
- index.ts - Esa class (API client)
- types.ts - Zod schemas and type definitions
scripts/build.ts - Bun build script (generates executable)

Build System

Uses Bun's native build capabilities to generate a single executable
Build configuration managed in scripts/build.ts
Dockerfile uses multi-stage build

How to Implement MCP Tools

Create new tool in src/mcp/tools/
Define input using zod schema
Register tool in src/mcp/tools/index.ts
Add to tools object in src/server.ts

Current Implementation Status

Basic MCP server structure implemented
esa.io API client (Esa class) with Bearer auth
Environment variables: ESA_TEAM, ESA_ACCESS_TOKEN

Implemented Tools

get_posts - fetches posts with filtering, sorting, pagination
get_post - fetches specific post by number
create_post - creates new post
update_post - updates existing post
delete_post - deletes post
get_tags - fetches all tags
get_post_comments - fetches comments for a post
create_post_comment - creates comment on post (write operation)
update_comment - updates existing comment
delete_comment - deletes comment

Read the full file on GitHub · 90 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

4d ago First seen · 90 lines · 705 tokens per session scan A 0c61b739b714

Subscribe to this mod's changes

esa-mcp-server CLAUDE.md is an instructions file published in the GitHub repository koki-develop/esa-mcp-server (2 stars, last pushed 11mo ago), licensed MIT. It adds 705 tokens to every session, about $0.0035 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

esa-mcp-server CLAUDE.md