# claudestat-mcp-bundle

MCP server bundle for [`@statforge/claudestat`](https://github.com/DeibyGS/claudestat) — wraps `createMcpServer()` into a standalone package with CLI and programmatic import.

## Install

```bash
npm install -g @statforge/claudestat-mcp-bundle
```

## Quick start

```bash
claudestat-mcp
```

Then add to Claude Code's `claude.json`:

```json
{
  "mcpServers": {
    "claudestat": {
      "command": "claudestat-mcp"
    }
  }
}
```

## Programmatic usage

```ts
import { createMcpServer } from '@statforge/claudestat-mcp-bundle'

const server = createMcpServer({
  contextPolling: true,
  tools: [
    { name: 'my_tool', description: 'Does something', inputSchema: {}, handler: () => 'hello' },
  ],
})
server.start()
```

## API

`createMcpServer(options?)` returns an `McpServer` with:
- `start()` — begin listening on stdin
- `stop()` — close stdin listener
- `addTool(def)` — register a tool at runtime
- `removeTool(name)` — unregister a tool
- `tools` — current tool list (readonly)

Options: `{ tools?, name?, version?, contextPolling? }`

## License

MIT