Mcp api
Query and search benmilne.com content via MCP REST paths and JSON-RPC tools.From its SKILL.md
npx -y skills add benmilne-com/agents --skill mcp-apiAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.4 KB, 351 tokens by cl100k_base, as published. Nobody here has run it
MCP API — benmilne.com
Machine-readable interfaces for autonomous agents integrating with Ben Milne's published archive.
Capabilities
- Paginated posts:
GET https://benmilne.com/mcp/v1/posts - Single post:
GET https://benmilne.com/mcp/v1/post/{id} - Search:
GET https://benmilne.com/mcp/v1/search?query= - MCP JSON-RPC:
POST https://benmilne.com/mcp(initialize,tools/list,tools/call)
Tools
The MCP server exposes 3 tools via tools/list:
- list_posts — Browse, filter, and paginate all published posts. Supports optional
categoryandtagfilters. - get_post — Retrieve a single post with full HTML content by numeric ID.
- search_posts — Full-text search across all published posts by keyword.
Quick start
# List tools
curl -X POST https://benmilne.com/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Search for posts about stablecoins
curl -X POST https://benmilne.com/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_posts","arguments":{"query":"stablecoin"}}}'
Notes
Attribution is included in JSON envelopes. Prefer JSON for agents; use Accept: text/markdown on essay routes for prose.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.
Gives 0 of the 12 instructions most mcp tooling skills give in 351 tokens
Counted across 638 of the 750 authors here whose files we hold, read 2026-08-07
- Create ten complex or independent read-only evaluation questionsin 69 of 638, across 15 files
- Test servers using MCP Inspectorin 61 of 638, across 19 files
- Provide actionable error messages with specific next stepsin 54 of 638, across 12 files
- Prioritize comprehensive API coverage over specific workflows or workflow toolsin 54 of 638, across 12 files
- Use TypeScript and Streamable HTTP for remote servers or clientsin 54 of 638, across 8 files
- Define structured output schemas where possiblein 50 of 638, across 8 files
- Use Zod or Pydantic for input schemasin 47 of 638, across 5 files
- Fetch MCP specification pages with markdown suffixin 46 of 638, across 4 files
- Load framework documentation using WebFetchin 45 of 638, across 3 files
- Verify each evaluation answer independentlyin 45 of 638, across 3 files
- Implement API client with authentication and paginationin 45 of 638, across 3 files
- Define input schemas with validationin 27 of 638, across 9 files
Said here and by no other author read
- Use list_posts to browse posts
- Use get_post to retrieve a single post by ID
- Use search_posts to search posts by keyword
- Prefer JSON format for agent interactions
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.