Skip to content
MCP server

Shinjuku Shield

Pay x402 sellers on Solana from a shielded USDC balance so the chain hides the payer

Runs locallyStatus and history
Install
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-shield

Add 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.

How AIPoweredBot checks servers