Shinjuku Shield — Claude Code MCP server for USDC payments
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.
no license ★ 11 updated 2026-11-13
claude mcp add --env SHIELDED_WALLET_HOME=<SHIELDED_WALLET_HOME> --env SHIELDED_WALLET_PASSPHRASE=<SHIELDED_WALLET_PASSPHRASE> --transport stdio shinjuku-shield -- npx -y shinjuku-shieldWhat Shinjuku Shield 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.
What it helps with
- 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 for the agent
- 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.
How to install Shinjuku Shield
Platform CLI
claude mcp add --env SHIELDED_WALLET_HOME=<SHIELDED_WALLET_HOME> --env SHIELDED_WALLET_PASSPHRASE=<SHIELDED_WALLET_PASSPHRASE> --transport stdio shinjuku-shield -- npx -y shinjuku-shieldReplace <…> with your own values
Platform CLI
codex mcp add shinjuku-shield --env SHIELDED_WALLET_HOME=<SHIELDED_WALLET_HOME> --env SHIELDED_WALLET_PASSPHRASE=<SHIELDED_WALLET_PASSPHRASE> -- npx -y shinjuku-shieldReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
gemini mcp add -e SHIELDED_WALLET_HOME=<SHIELDED_WALLET_HOME> -e SHIELDED_WALLET_PASSPHRASE=<SHIELDED_WALLET_PASSPHRASE> shinjuku-shield npx -y shinjuku-shieldReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Shinjuku Shield
How do I install Shinjuku Shield in Claude Code?
Run claude mcp add shinjuku-shield -e SHIELDED_WALLET_PASSPHRASE=<SHIELDED_WALLET_PASSPHRASE> -- npx -y shinjuku-shield. Set up the wallet first with npm install -g shinjuku, then shinjuku setup.
What does Shinjuku Shield do?
It gives an agent access to a shielded USDC balance on Solana for finding x402 sellers, checking prices, and paying for services. Wallet keys stay on the user's computer.
What does Shinjuku Shield need to run?
Wallet setup requires npm install -g shinjuku and shinjuku setup. Claude Code receives the wallet passphrase through SHIELDED_WALLET_PASSPHRASE; payments use USDC and do not require SOL for network fees.