# MCP

> Guide for working with Splitrail's MCP server. Use when adding tools, resources, or modifying the MCP interface. Use when this capability is needed.

- Skill: `tomevault-io/mcp` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/mcp/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/mcp

---


# 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

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/piebald-ai) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->