Shinjuku Shield
Pay x402 sellers on Solana from a shielded USDC balance so the chain hides the payer
- Platforms
- CLI
- Runs
- Locally
- Version
- 0.3.218
- Listing updated
- today
Similar MCP servers
About Shinjuku Shield
Shinjuku Shield is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add shinjuku-shield --env SHIELDED_WALLET_PASSPHRASE='<SHIELDED_WALLET_PASSPHRASE>' -- npx -y shinjuku-shieldAdd to claude_desktop_config.json
{
"mcpServers": {
"shinjuku-shield": {
"command": "npx",
"args": [
"-y",
"shinjuku-shield"
],
"env": {
"SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"shinjuku-shield": {
"command": "npx",
"args": [
"-y",
"shinjuku-shield"
],
"env": {
"SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"shinjuku-shield": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"shinjuku-shield"
],
"env": {
"SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"shinjuku-shield": {
"command": "npx",
"args": [
"-y",
"shinjuku-shield"
],
"env": {
"SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"shinjuku-shield": {
"command": "npx",
"args": [
"-y",
"shinjuku-shield"
],
"env": {
"SHIELDED_WALLET_PASSPHRASE": "<SHIELDED_WALLET_PASSPHRASE>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
SHIELDED_WALLET_HOMEThe private folder that holds the encrypted wallet and config.json. Default: ~/.carbon-shielded-wallet (the folder that setup uses).SHIELDED_WALLET_PASSPHRASEThe wallet passphrase, if you do not use --passphrase-file.
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Pricing unknown
Facilitator fees not published
Prices change. Check shinjukustaition.com before you buy.
Shinjuku Shield 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.



