# Shinjuku Shield

> Shinjuku Shield is an MCP server for finance and payments. Pay x402 sellers on Solana from a shielded USDC balance so the chain hides the payer. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Website:** https://shinjukustaition.com
- **Repository:** https://github.com/shinjukustaition/shinjuku-shield
- **MCP Registry name:** io.github.ShinjukuStaition/shinjuku-shield
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

Shinjuku Shield runs on your own machine and holds your keys there. You shield USDC into a pool, and when a seller answers 402 Payment Required your wallet pays the Shinjuku facilitator privately; Shinjuku then pays the seller from its own account. On chain the seller sees a payment from Shinjuku, not from your wallet.

Spending caps are optional and set during setup, and a tool call can only lower them. Tools listed in the README include adding funds through a one-time deposit address, shielding a balance, discovering sellers from public x402 listings such as the Coinbase Bazaar and PayAI, and previewing a price against your caps without paying.

No SOL is needed because the facilitator relayer pays network fees. The README says it works today in Claude Code and in a terminal, and the project also describes a private-AI feature and a game called the market.

## Features

- **Shielded balance:** Move USDC into a pool so it becomes private notes only your keys can spend.
- **Payer hidden on chain:** The seller is paid by the facilitator, so your wallet is not in that transfer.
- **Seller discovery:** Search public x402 listings on your own machine.
- **Preview before paying:** See the price and whether your caps allow it without spending.
- **No SOL needed:** The relayer covers network fees; you only need USDC.

## Good for

- Let an agent buy API calls without exposing its wallet history
- Set spending caps for autonomous purchases
- Find x402 sellers that accept Solana
- Top up a private balance from an exchange

## Install

### Claude Code (Terminal)

```sh
claude mcp add shinjuku-shield --env SHIELDED_WALLET_PASSPHRASE='<SHIELDED_WALLET_PASSPHRASE>' -- npx -y shinjuku-shield
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "shinjuku-shield": {
      "command": "npx",
      "args": [
        "-y",
        "shinjuku-shield"
      ],
      "env": {
        "SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shinjuku-shield": {
      "command": "npx",
      "args": [
        "-y",
        "shinjuku-shield"
      ],
      "env": {
        "SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "shinjuku-shield": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "shinjuku-shield"
      ],
      "env": {
        "SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shinjuku-shield": {
      "command": "npx",
      "args": [
        "-y",
        "shinjuku-shield"
      ],
      "env": {
        "SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shinjuku-shield": {
      "command": "npx",
      "args": [
        "-y",
        "shinjuku-shield"
      ],
      "env": {
        "SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
      }
    }
  }
}
```

## Tools

- `wallet_add_funds`: Gives a one-time deposit address to add USDC.
- `wallet_shield`: Moves USDC into the shielded pool.
- `x402_discover`: Searches public x402 seller listings.
- `x402_preview`: Shows the price and whether your caps allow it, without paying.

## FAQ

### Who holds my keys?

You do. The server runs locally and the keys never leave your machine.

### Do sellers need to change anything?

No. Sellers keep their standard x402 exact offer.

### Is a spending cap required?

No. Caps are optional; by default only the balance limits a payment.

### Which wallet environment variables does it use?

SHIELDED_WALLET_HOME for the wallet folder and SHIELDED_WALLET_PASSPHRASE for the passphrase.

### How do I add Shinjuku Shield to Claude Code?

Run this command in your terminal: claude mcp add shinjuku-shield --env SHIELDED_WALLET_PASSPHRASE='<SHIELDED_WALLET_PASSPHRASE>' -- npx -y shinjuku-shield

### What are the best alternatives to Shinjuku Shield?

The closest alternatives to Shinjuku Shield are REA, AiSOC, Solana MCP by Vybe, redamon and x64dbg-mcp-server.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [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.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [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.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.

---
Source: https://ai-powered.com/mcp/shinjuku-shield
