# Shiwake MCP

> Shiwake MCP is an open-source MCP server for finance and payments. Journal entry testing for accounting audits, with 15 screening rules and no dependencies. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Website:** https://zenn.dev/ushikundesu/articles/shiwake-mcp-zero-dependency
- **Repository:** https://github.com/ushikundesuyo/shiwake-mcp
- **MCP Registry name:** io.github.USHIKUNDESUYO/shiwake-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

Shiwake MCP was written by a certified public accountant in Japan and has an empty dependencies list in package.json, which the author argues makes it easier to approve inside audit firms. It reads a general ledger, applies 15 rules and returns journal entries ordered by risk score, so a reviewer looks at the most unusual ones first.

The bundled demo screens 383 synthetic entries with known anomalies and narrows them to 25. Rules cover things like after-hours entry, round amounts, amounts just under an approval limit, duplicate entries, the same person preparing and approving, period-end large postings and unbalanced entries. Large ledgers are passed by file path from folders allowed with --data-dir, in JSON or CSV (UTF-8 or Shift_JIS), up to 256 MB.

The documentation is mostly in Japanese. The code is MIT licensed and needs Node.js 20 or later.

## Features

- **15 screening rules:** Flags unusual journal entries such as self-approval, duplicates and entries just under approval limits.
- **Risk-ranked output:** Orders entries by a score summed from rule severity.
- **Benford analysis:** Reports first-digit distribution, MAD and chi-squared for amounts.
- **File-based input:** Reads large ledgers from allowed folders instead of pasting entries into chat.
- **Zero dependencies:** Runs on Node.js with no installed packages.
- **Bundled demo:** Includes 383 synthetic entries with seeded anomalies.

## Good for

- Screen a year of general ledger entries before an audit
- Find entries posted outside business hours or on holidays
- Check that debits and credits balance
- Look for duplicate journal entries
- Test amount distributions against Benford's law

## Install

### Claude Code (Terminal)

```sh
claude mcp add shiwake-mcp -- npx -y shiwake-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shiwake-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shiwake-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "shiwake-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shiwake-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "shiwake-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "shiwake-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "shiwake-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shiwake-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "shiwake-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "shiwake-mcp"
      ]
    }
  }
}
```

## Tools

- `screen_journals`: Applies all rules and returns journal entries ordered by risk score.
- `check_balance`: Finds entries whose debits and credits do not match and gives the difference.
- `benford_analysis`: Reports the leading-digit distribution of amounts with MAD and chi-squared.
- `detect_duplicates`: Groups journal entries that match exactly.
- `list_rules`: Lists the implemented rules and their purpose.

## FAQ

### Which tools does it have?

screen_journals, check_balance, benford_analysis, detect_duplicates and list_rules.

### What does it need?

Node.js 20 or later. You can start it with npx -y shiwake-mcp@0.3.1.

### How are large ledgers handled?

Pass a .json or .csv file path; the folder must be allowed with --data-dir. Files up to 256 MB are accepted, and the README reports about 9 seconds for 380,000 rows.

### What licence is it under?

MIT.

### Is Shiwake MCP free?

Yes. Shiwake MCP is open source, so you can use and self-host it for free.

### How do I add Shiwake MCP to Claude Code?

Run this command in your terminal: claude mcp add shiwake-mcp -- npx -y shiwake-mcp

### What are the best alternatives to Shiwake MCP?

The closest alternatives to Shiwake MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/shiwake-mcp
