io.github.Shawn5cents/agentskin — Model Context Protocol (MCP) Server

The MCP server “io.github.Shawn5cents/agentskin” provides the Semantic Layer for AI Agents by pruning noisy API data to make token-efficient reasoning possible. It is presented as part of an “AgentSkin Suite” focused on reducing “Token Tax” across the agent workflow, including API responses and other outputs.

🛠️ Key Features

Semantic JSON pruning via MCP (listed as “AgentSkin SSS”)
Token savings on pruned API data reported as 60–88% (range shown in the source excerpt)

🚀 Use Cases

Token-efficient reasoning for AI coding agents
Reducing noisy API data before an agent consumes it

⚡ Developer Benefits

Semantic JSON pruning intended to improve how agent inputs are represented
Token-efficient processing by pruning output noise

⚠️ Limitations

Source material only includes the Semantic JSON pruning component and partial suite details; additional components and exact behaviors are not fully provided.

Component

What It Does

Savings

Creator

AgentSkin SSS

Semantic JSON pruning via MCP

60–88% on rich APIs

Shawn Nichols Sr.

Tokenjuice CLI

Rule-driven terminal output compaction

Up to 99.97% on large outputs

Vincent Koc (MIT)

Caveman

Output compression via prompt engineering

65% output reduction

Julius Brussee

By the Numbers

Metric

Value

GitHub API savings

88.3% (1,544 → 180 tokens)

ls -laR directory listing

99.97% (3.19M → 897 chars)

Caveman output compression

65% average

Caveman memory compression

46% smaller

MCP tools

7 across unified server

Combined test suite

4,695 tests, 274 files — 100% passing

Pipeline throughput

3,030 fixtures/sec (0.33ms avg)

Net session savings

17.1% (zero overhead via bash hook)

Documentation

Doc

Description

OVERVIEW.md

Project overview and quick start

ARCHITECTURE.md

Technical architecture and data flow

STATUS.md

Phase completion and test coverage

BENCHMARK.md

Live API compression benchmarks

USAGE.md

Full usage guide — hook, caveman, MCP

THREE-LAYER-RULES.md

Rule config override semantics

AUTHORS.md

Credits and component details

Creator

Contribution

Shawn Nichols Sr. (Nichols Transco LLC)

AgentSkin SSS protocol, MCP server, Suite integration

Vincent Koc

Tokenjuice — MIT License

Julius Brussee

Caveman — github.com/JuliusBrussee/caveman

Install

Configuration

Environment variables

BRAVE_SEARCH_API_KEYsecret

Brave Search API Key

SERPER_API_KEYsecret

Serper.dev Search API Key

TAVILY_API_KEYsecret

Tavily Search API Key

APILAYER_KEYsecret

MediaStack API Key

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentskin": {
      "command": "npx",
      "args": [
        "-y",
        "agentskin@4.0.1"
      ],
      "env": {
        "BRAVE_SEARCH_API_KEY": "<YOUR_BRAVE_SEARCH_API_KEY>",
        "SERPER_API_KEY": "<YOUR_SERPER_API_KEY>",
        "TAVILY_API_KEY": "<YOUR_TAVILY_API_KEY>",
        "APILAYER_KEY": "<YOUR_APILAYER_KEY>"
      }
    }
  }
}

io.github.Shawn5cents/agentskin