# Shinjuku Shield

The Shinjuku Shield MCP server for Claude Code lets an agent make private x402 payments in USDC on Solana. It can find sellers, check a price, and pay from a shielded balance.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 repo stars
- Author: ShinjukuStaition
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ShinjukuStaition/shinjuku-shield
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/shinjuku-shield

## What it does

Shinjuku Shield gives an agent tools to fund a shielded USDC balance, pay x402 sellers, and withdraw funds on Solana. `x402_discover` searches listings, while `x402_preview` checks the price and spending limits without making a payment.

The wallet keys stay on the user's computer, and the chain does not reveal which wallet paid the seller. Funds can come from another wallet or exchange; SOL is not needed for network fees. Spending caps are set during setup. Reusing a `request_id` resumes the same operation instead of starting another one.

Wallet setup uses `npm install -g shinjuku` followed by `shinjuku setup`; the MCP server is then added to the agent host. The Claude Code configuration passes the wallet passphrase through `SHIELDED_WALLET_PASSPHRASE`.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `SHIELDED_WALLET_HOME`, `SHIELDED_WALLET_PASSPHRASE` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env SHIELDED_WALLET_HOME=<SHIELDED_WALLET_HOME> --env SHIELDED_WALLET_PASSPHRASE=<SHIELDED_WALLET_PASSPHRASE> --transport stdio shinjuku-shield -- npx -y shinjuku-shield
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add shinjuku-shield --env SHIELDED_WALLET_HOME=<SHIELDED_WALLET_HOME> --env SHIELDED_WALLET_PASSPHRASE=<SHIELDED_WALLET_PASSPHRASE> -- npx -y shinjuku-shield
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "shinjuku-shield": {
            "command": "npx",
            "args": [
                "-y",
                "shinjuku-shield"
            ],
            "env": {
                "SHIELDED_WALLET_HOME": "<SHIELDED_WALLET_HOME>",
                "SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "shinjuku-shield": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "shinjuku-shield"
            ],
            "env": {
                "SHIELDED_WALLET_HOME": "<SHIELDED_WALLET_HOME>",
                "SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e SHIELDED_WALLET_HOME=<SHIELDED_WALLET_HOME> -e SHIELDED_WALLET_PASSPHRASE=<SHIELDED_WALLET_PASSPHRASE> shinjuku-shield npx -y shinjuku-shield
```
Replace <…> with your own values

## When to use it
- fund a shielded USDC balance
- find sellers that accept x402 payments
- check a price against spending caps
- pay a Solana x402 seller privately

## Example prompts
- Find x402 sellers for this service.
- Check this address's price and whether my limits allow payment, without paying.
- Pay this x402 seller from my shielded USDC balance.

## Similar
- [x402 Universal Payer](https://affpapa.org/en/nevibecode/mcp/x402-universal-payer.md) — MCP server · ★ 284 repo stars
- [x402 Gateway — ScriptMasterLabs](https://affpapa.org/en/nevibecode/mcp/x402-gateway-scriptmasterlabs.md) — MCP server · 223 installs
- [MoltPe](https://affpapa.org/en/nevibecode/mcp/moltpe.md) — MCP server · 170 installs
- [x402 Wallet](https://affpapa.org/en/nevibecode/mcp/x402-wallet.md) — MCP server · ★ 284 repo stars
- [mcp-x402](https://affpapa.org/en/nevibecode/mcp/mcp-x402.md) — MCP server · ★ 279 repo stars
- [ZendIQ](https://affpapa.org/en/nevibecode/mcp/zendiq.md) — MCP server · ★ 1 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
