English Français العربية

io.github.Shawn5cents/agentskin

Official registry AI and agents

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

Source code Documentation

What can you do with io.github.Shawn5cents/agentskin?

  • compress — one front door that auto-detects JSON, CLI output, or plain text.
  • fetch_optimized_data — fetches a public URL and applies URL-specific pruning rules when available.
  • reduce — compacts terminal output using Tokenjuice's rule-driven reducers.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package agentskin
Claude Code 
claude mcp add agentskin -e 'BRAVE_SEARCH_API_KEY=<your brave_search_api_key>' -e 'SERPER_API_KEY=<your serper_api_key>' -e 'TAVILY_API_KEY=<your tavily_api_key>' -e 'APILAYER_KEY=<your apilayer_key>' -- npx -y agentskin@4.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "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>"
            }
        }
    }
}

Environment variables

  • BRAVE_SEARCH_API_KEY secret Brave Search API Key
  • SERPER_API_KEY secret Serper.dev Search API Key
  • TAVILY_API_KEY secret Tavily Search API Key
  • APILAYER_KEY secret MediaStack API Key

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. AgentSkin
  2. What it does
  3. Quick start
  4. Design rule
  5. Current verification
  6. Runtime
  7. Development
  8. Credits

AgentSkin

Context middleware for AI agents. AgentSkin removes low-value API, JSON, and terminal noise before it enters model context.

The frozen AgentSkin 5.1 offline core evaluation also has an accepted Sparse Env execution path. AgentSkin preserves the workload correctness contract while Sparse Env owns cold/warm environment selection and lifecycle; see agentskin/docs/SPARSE_ENV.md.

What it does

AgentSkin has three primary workflows:

  • compress — one front door that auto-detects JSON, CLI output, or plain text.
  • fetch_optimized_data — fetches a public URL and applies URL-specific pruning rules when available.
  • reduce — compacts terminal output using Tokenjuice's rule-driven reducers.

Five advanced tools remain for compatibility and diagnostics: apply_json_semantic, classify_url, strip_ansi, estimate_tokens, and skin_reasoning.

Quick start

npx -y agentskin@latest

MCP config:

{
  "mcpServers": {
    "agentskin": {
      "command": "npx",
      "args": ["-y", "agentskin@latest"]
    }
  }
}

Design rule

Fidelity first, compression second. Explicit signals and URL rules are authoritative. Generic keys such as id, name, and url are only fallback signals when no explicit rule exists.

A reduction is useful only when the information required by the task survives it.

Current verification

The release gate runs the AgentSkin-owned test suite, including MCP startup/security and live HTTP integration tests. Run it with:

cd agentskin
npm ci
npm test

Benchmarks are workload-specific. The test suite prints measured reductions for its fixtures instead of claiming one universal savings percentage.

Runtime

  • Node.js MCP server over stdio
  • Tokenjuice is a normal npm dependency for CLI reduction
  • URL-specific semantic pruning rules for structured APIs
  • SSRF checks for fetches, response-size limits, rate limiting, Zod validation, and processing timeouts

Development

The npm package lives in agentskin/ inside this repository.

cd agentskin
npm ci
npm test
npm run lint
npm pack --dry-run

Credits

AgentSkin semantic pruning and MCP integration: Shawn Nichols Sr. / Nichols Transco LLC.

CLI reduction uses Tokenjuice by Vincent Koc under its MIT license.

Frequently asked questions

What is io.github.Shawn5cents/agentskin?

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

How do I install io.github.Shawn5cents/agentskin?

It runs on your machine. In Claude Code: claude mcp add agentskin -e 'BRAVE_SEARCH_API_KEY=<your brave_search_api_key>' -e 'SERPER_API_KEY=<your serper_api_key>' -e 'TAVILY_API_KEY=<your tavily_api_key>' -e 'APILAYER_KEY=<your apilayer_key>' -- npx -y agentskin@4.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Shawn5cents/agentskin need an API key?

Yes. It expects BRAVE_SEARCH_API_KEY, SERPER_API_KEY, TAVILY_API_KEY, APILAYER_KEY, which you set in its configuration.

Is io.github.Shawn5cents/agentskin open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.Shawn5cents/agentskin?

It is published by Shawn5cents. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.