Agent skill

MCP

by Piebald-AI in Piebald-AI/splitrail

Guide for working with Splitrail's MCP server. An agent skill from Piebald-AI/splitrail.

MITAuto-check passedAgent Workflows

Install MCP

skills CLI
$ npx skills add Piebald-AI/splitrail --skill mcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Piebald-AI/splitrail mcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Piebald-AI/splitrail.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/mcp .claude/skills/mcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mcp
GitHub stars
223
Token cost
~335 tokens
SKILL.md length
135 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Guide for working with Splitrail's MCP server. An agent skill from Piebald-AI/splitrail.

  • Works in 2 steps: Define the tool handler in… → Add request/response types to…
  • Modifying the MCP interface
  • SKILL.md covers Source Files, Available Tools, Resources and Adding a New Tool, plus 1 more section
  • Calls cargo

What it does

MCP is an agent skill from Piebald-AI/splitrail. Guide for working with Splitrail's MCP server. Use when adding tools, resources, or modifying the MCP interface.

Its SKILL.md is about 340 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol and Qwen. The repository describes itself as: Fast, cross-platform, real-time token usage tracker and cost monitor for Claude Code / Codex CLI / Antigravity CLI / Qwen Code / Cline / Zoo Code / Kilo Code / GitHub Copilot /… The licence is MIT.

When your agent uses it

  • Modifying the MCP interface
  • Tasks that involve MCP servers

Example prompts

  • “/mcp”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Define the tool handler in src/mcp/server.rs using the #[tool] macro
  2. Add request/response types to src/mcp/types.rs if needed

What it can do on your machine

Read from SKILL.md and the folder at commit f9a8f6d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • cargo

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

MCP loads about 335 tokens when it runs. Until then it costs about 29 tokens; SKILL.md has 135 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~29
When it runs · the whole SKILL.md, loaded when a task matches
~335

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Piebald-AI/splitrail at commit f9a8f6d, republished under its MIT licence (© Piebald-AI). 135 words, ~335 tokens.

Download SKILL.mdSave it as .claude/skills/mcp/SKILL.md (or your agent's skills folder).
name
mcp
description
Guide for working with Splitrail's MCP server. Use when adding tools, resources, or modifying the MCP interface.

MCP Server

Splitrail can run as an MCP server, allowing AI assistants to query usage statistics programmatically.

bash
cargo run -- mcp

Source Files

  • src/mcp/mod.rs - Module exports
  • src/mcp/server.rs - Server implementation and tool handlers
  • src/mcp/types.rs - Request/response types

Available Tools

  • get_daily_stats - Query usage statistics with date filtering
  • get_model_usage - Analyze model usage distribution
  • get_cost_breakdown - Get cost breakdown over a date range
  • get_file_operations - Get file operation statistics
  • compare_tools - Compare usage across different AI coding tools
  • list_analyzers - List available analyzers

Resources

  • splitrail://summary - Daily summaries across all dates
  • splitrail://models - Model usage breakdown

Adding a New Tool

  1. Define the tool handler in src/mcp/server.rs using the #[tool] macro
  2. Add request/response types to src/mcp/types.rs if needed

See existing tools in src/mcp/server.rs for the pattern.

Adding a New Resource

  1. Add URI constant to resource_uris module in src/mcp/server.rs
  2. Add to list_resources() method
  3. Handle in read_resource() method

© Piebald-AI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/mcp of Piebald-AI/splitrail.

Open the folder on GitHubat commit f9a8f6d

Compare with similar skills

MCP next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

MCP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
MCP this skillPiebald-AI/splitrail223—~335Automated safety check: PassMIT
Marm InitLyellr88/marm-memory419—~7.5kAutomated safety check: NotesApache-2.0
Extension CreatorQwenLM/qwen-code28k—~5kAutomated safety check: WarnApache-2.0
Qwen Code E2E TestingQwenLM/qwen-code28k—~2.1kAutomated safety check: PassApache-2.0
Browser UseQwenLM/qwen-code-examples143—~451Automated safety check: PassNone
Computer UseQwenLM/qwen-code-examples143—~632Automated safety check: PassNone

Similar skills

  • Marm Init

    Lyellr88/marm-memory

    Guided MARM MCP setup. An agent skill from Lyellr88/marm-memory.

    419 GitHub stars~7.5k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check: notes
  • Extension Creator

    QwenLM/qwen-code

    Create, scaffold, customize, validate, and locally test Qwen Code extensions.

    28k GitHub stars~5k tokensUpdated today
    Agent WorkflowsAuto-check: warnings
  • Qwen Code E2E Testing

    QwenLM/qwen-code

    Guides end-to-end testing of the Qwen Code CLI in headless mode with real model calls, MCP test servers and inspection of raw API traffic.

    28k GitHub stars~2.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Browser Use

    QwenLM/qwen-code-examples

    Control browser pages using the Playwright MCP server. An agent skill from QwenLM/qwen-code-examples.

    143 GitHub stars~451 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Computer Use

    QwenLM/qwen-code-examples

    Control the local desktop using the computer MCP tool from computer-use-mcp.

    143 GitHub stars~632 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Local AI Agents

    microsoft/ai-agents-for-beginners

    Official

    Build local-first AI agents that run entirely on a developer workstation with Microsoft Foundry Local and Qwen function-calling models.

    77k GitHub stars~1.3k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

More from Piebald-AI/splitrail

  • Pricing

    Piebald-AI/splitrail

    Guide for updating model pricing in Splitrail. An agent skill from Piebald-AI/splitrail.

    223 GitHub stars~783 tokensUpdated today
    Auto-check passed
  • New Analyzer

    Piebald-AI/splitrail

    Guide for adding a new AI coding agent analyzer to Splitrail.

    223 GitHub stars~326 tokensUpdated today
    Auto-check passed
  • Performance

    Piebald-AI/splitrail

    Performance optimization guidelines for Splitrail. An agent skill from Piebald-AI/splitrail.

    223 GitHub stars~245 tokensUpdated today
    Auto-check passed
  • Tui

    Piebald-AI/splitrail

    Guide for Splitrail's terminal UI and file watching. An agent skill from Piebald-AI/splitrail.

    223 GitHub stars~349 tokensUpdated today
    Auto-check passed
  • Types

    Piebald-AI/splitrail

    Reference for Splitrail's core data types. An agent skill from Piebald-AI/splitrail.

    223 GitHub stars~271 tokensUpdated today
    Auto-check passed

Categories

Questions about MCP

What does MCP do?

Guide for working with Splitrail's MCP server. An agent skill from Piebald-AI/splitrail. MCP is an agent skill from Piebald-AI/splitrail. Guide for working with Splitrail's MCP server.

When should I use MCP?

MCP fits situations like: modifying the MCP interface; tasks that involve MCP servers.

How do I install MCP in Claude Code?

Run `npx skills add Piebald-AI/splitrail --skill mcp -a claude-code`. Or copy the skill folder (.claude/skills/mcp in Piebald-AI/splitrail) into .claude/skills/mcp in your project. Claude Code loads it when a task matches its description.

How do I install MCP in Codex?

Run `npx skills add Piebald-AI/splitrail --skill mcp -a codex`. Or copy the skill folder (.claude/skills/mcp in Piebald-AI/splitrail) into .agents/skills/mcp in your project. Codex loads it when a task matches its description.

Can I use MCP in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Piebald-AI/splitrail --skill mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mcp, .gemini/skills/mcp, .github/skills/mcp and .opencode/skills/mcp in your project.

What does MCP need to run?

Going by SKILL.md and its folder, MCP needs the command-line tools its instructions call (cargo).

Does MCP access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is MCP safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does MCP use?

MCP is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does MCP use?

About 335 tokens (SKILL.md is roughly 1.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to MCP?

Skills that share tags, products or a category with MCP: Marm Init (Lyellr88/marm-memory, 419 stars), Extension Creator (QwenLM/qwen-code, 28k stars), Qwen Code E2E Testing (QwenLM/qwen-code, 28k stars) and Browser Use (QwenLM/qwen-code-examples, 143 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains MCP?

Piebald-AI (a GitHub organization) maintains it in Piebald-AI/splitrail, which has 223 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 9, 2026.

Source: Piebald-AI/splitrail on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.