/mcp

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.

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