Minimal MCP (Model Context Protocol) HTTP server for AGENTS.md and structured tasks, with versioned history (logs/revert) and an ephemeral scratchpad, exposed over a Streamable HTTP endpoint. The…
Agents.md is an MCP project maintained in the benhaotang/mcp-http-agent-md repository. The maintainer describes its purpose as “Minimal MCP (Model Context Protocol) HTTP server for AGENTS.md and structured tasks, with versioned history (logs/revert) and an ephemeral scratchpad, exposed over a Streamable HTTP…”. Read the project documentation for the complete scope.
The maintainer’s configuration uses `http://localhost:3000/mcp?apiKey=USER_API_KEY``. Check the project’s account and authentication instructions when adding the endpoint to your client.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| list_projects | List all project names. |
| init_project | Create/init project { name, agent?, progress? }. Immediately creates an initial backup (commit) and returns hash. |
| delete_project | Delete project { name }. (owner only) |
| rename_project | Rename project { oldName, newName, comment? } (owner only). Returns updated hash. |
| read_agent | Read AGENTS.md { name }. |
| write_agent | Write AGENTS.md { name, content, comment? }. Patch/diff also supported; responses include updated hash. |
| read_progress | Read structured tasks for a project { name, only? }. Returns JSON { tasks: [...], markdown: "..." } where markdown is a nested, human-friendly outline. only… |
| progress_add | Add one or more structured tasks { name, item, comment? }. Creates a commit when tasks are added; returns hash. |
| progress_set_new_state | Update tasks by task_id (8-char) or by matching task_info substring { name, match, state?, task_info?, parent_id?, extra_note?, comment? }. Creates a commit… |
| generate_task_ids | Generate N unique 8-character IDs not used by this user { count? } (default 5). Returns { ids: ["abcd1234", ...] }. |
| get_agents_md_best_practices_and_examples | Returns best practices and examples from example_agent_md.json. Default returns only the_art_of_writing_agents_md (best-practices). Use include='all' to… |
| list_project_logs | List commit logs { name } → { logs: [{ hash, message, modified_by, created_at }] }. The modified_by field shows who made each commit. |
| revert_project | Revert to an earlier hash { name, hash }. Shared participants can only revert to commits in their most recent consecutive sequence (to prevent discarding… |
| list_file | List uploaded documents for a project { project_id }. Returns each file's original filename, description, and file_id for reference. |
| read_project_file | Read a specific chunk of an uploaded project document { project_id, file_id, start?, length?, pages? }. Returns UTF-8 text (PDFs parsed to text). Defaults to… |
| scratchpad_initialize | Start a new scratchpad for a one‑off task { name, tasks }. The server generates and returns a random scratchpad_id. tasks is up to 6 items { task_id, status… |
| review_scratchpad | Review a scratchpad by { name, scratchpad_id, IncludeCM?, IncludeTk? }. |
| IncludeCM | boolean; when true, include common_memory in the output. |
| IncludeTk | array of strings; filters tasks by task_id (case-insensitive exact) or task_info (case-insensitive substring). When provided, only matching tasks are returned. |
| scratchpad_update_task | Update existing scratchpad tasks by task_id { name, scratchpad_id, updates }, where updates is an array of { task_id, status?, task_info?, scratchpad?… |
| scratchpad_append_common_memory | Append to the scratchpad’s shared memory { name, scratchpad_id, append } where append is a string or array of strings. Returns the updated scratchpad. |
| scratchpad_subagent | Start a subagent to work on a scratchpad task { name, scratchpad_id, task_id, prompt, sys_prompt?, tool?, file_id?, file_path? }. Tools depend on provider… |
| scratchpad_subagent_status | Check run status { name, run_id }. Returns final status, or polls for up to ~25s when still running. |
{
"mcpServers": {
"mcp-agent-md": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"http://localhost:3000/mcp?apiKey=USER_API_KEY`"
]
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
The original Chromium automation reference server — simple, screenshot-driven browser control.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
MCP Server for emojikey.io ... save your unique relationship state and interaction style with your favorite LLM
Implementation of an MCP (Model Context Protocol) Server for SQLite. It provides an AI model with context and the ability to execute SQL queries.
An MCP server that enables control of Philips Hue lights through Claude and other LLM interfaces using the OpenHue CLI.
A comprehensive, intelligent, and extensible testing automation platform powered by Large Language Models. Test Automator streamlines the process of