Back to Browse

Agentskin MCP Server

Developer ToolsUse Caution4.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

The Semantic Layer for AI Agents. Prunes noisy API data by 70%+ for token-efficient reasoning.

About

The Semantic Layer for AI Agents. Prunes noisy API data by 70%+ for token-efficient reasoning.

Security Report

4.0
Use Caution4.0High Risk

Valid MCP server (2 strong, 4 medium validity signals). 7 known CVEs in dependencies (0 critical, 5 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

7 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Brave Search API KeyRequired

Environment variable: BRAVE_SEARCH_API_KEY

Serper.dev Search API KeyRequired

Environment variable: SERPER_API_KEY

Tavily Search API KeyRequired

Environment variable: TAVILY_API_KEY

MediaStack API KeyRequired

Environment variable: APILAYER_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-shawn5cents-agentskin": {
      "env": {
        "APILAYER_KEY": "your-apilayer-key-here",
        "SERPER_API_KEY": "your-serper-api-key-here",
        "TAVILY_API_KEY": "your-tavily-api-key-here",
        "BRAVE_SEARCH_API_KEY": "your-brave-search-api-key-here"
      },
      "args": [
        "-y",
        "agentskin-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

AgentSkin Suite

npm version License: MIT

The complete token optimization stack for AI coding agents. Three complementary tools that eliminate the "Token Tax" across the full agent cycle — API responses, CLI output, and agent replies.

The Suite

ComponentWhat It DoesSavingsCreator
AgentSkin SSSSemantic JSON pruning via MCP60–88% on rich APIsShawn Nichols Sr.
Tokenjuice CLIRule-driven terminal output compactionUp to 99.97% on large outputsVincent Koc (MIT)
CavemanOutput compression via prompt engineering65% output reductionJulius Brussee

Quick Start

# 1. AgentSkin MCP server
npx -y agentskin@latest

# 2. Bash hook (transparent CLI optimization)
source .agents/hooks/bash-optimizer.sh

# 3. Caveman — already active via AGENTS.md

By the Numbers

MetricValue
GitHub API savings88.3% (1,544 → 180 tokens)
ls -laR directory listing99.97% (3.19M → 897 chars)
Caveman output compression65% average
Caveman memory compression46% smaller
MCP tools7 across unified server
Combined test suite4,695 tests, 274 files — 100% passing
Pipeline throughput3,030 fixtures/sec (0.33ms avg)
Net session savings17.1% (zero overhead via bash hook)

Tools

AgentSkin Suite MCP (7 tools, unified)

fetch_optimized_data · skin_reasoning · classify_url · strip_ansi · reduce · estimate_tokens · apply_json_semantic

Caveman Skills (6 skills)

caveman · caveman-commit · caveman-review · caveman-stats · caveman-compress · cavecrew

Documentation

DocDescription
OVERVIEW.mdProject overview and quick start
ARCHITECTURE.mdTechnical architecture and data flow
STATUS.mdPhase completion and test coverage
BENCHMARK.mdLive API compression benchmarks
USAGE.mdFull usage guide — hook, caveman, MCP
THREE-LAYER-RULES.mdRule config override semantics
AUTHORS.mdCredits and component details

Security

  • SSRF Protection: Blocks private IPv4/IPv6 ranges and cloud metadata services
  • Rate Limiting: 60 req/min sliding window
  • Input Validation: Zod schemas for all tool inputs
  • Processing Timeout: 30-second limit

Credits

CreatorContribution
Shawn Nichols Sr. (Nichols Transco LLC)AgentSkin SSS protocol, MCP server, Suite integration
Vincent KocTokenjuice — MIT License
Julius BrusseeCaveman — github.com/JuliusBrussee/caveman

Website

agentskin.dev — Protocol specification, examples, FAQ, and whitepaper.


© 2026 Nichols Transco LLC.

Reviews

No reviews yet

Be the first to review this server!

Agentskin MCP Server - The Semantic Layer for AI Agents. Prunes noisy API data by | MCP Marketplace