402sentinel Mcp

Name: 402sentinel Mcp
Author: kaditang

by kaditangcommunityv0.7.1

This MCP server provides tools to assess the risk of an x402 counterparty or payment before authorizing a USDC payment, returning a 0-100 risk score, a decision, and wallet spending policy recommendations. It also lets callers report payment outcomes to improve future scoring and includes a buyer-side firewall for detecting suspicious payment instructions.

From the registry: x402 payment safety for AI agents: counterparty risk gate, payment firewall, compliance, RWA gate.

GitHub Repository Website

Install & configure

Prerequisites

required
Install the MCP server package
Install the 402sentinel MCP server globally from npm.
```
$ npm i -g @kaditang/402sentinel-mcp
```
optional
Fund a Base wallet with USDC in Circle Gateway balance
For paid tools, you need a Base wallet private key whose wallet has USDC available via Circle Gateway/x402. The README states free tools do not require the private key.

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `402sentinel-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install the MCP server package** — Install the 402sentinel MCP server globally from npm. Run: `npm i -g @kaditang/402sentinel-mcp`

Optional prerequisites:
- Fund a Base wallet with USDC in Circle Gateway balance — For paid tools, you need a Base wallet private key whose wallet has USDC available via Circle Gateway/x402. The README states free tools do not require the private key.

Canonical MCP server config (stdio transport):
- command: `402sentinel-mcp`
- args: []
- optional environment variables:
  - `CLIENT_PRIVATE_KEY`: Private key for a Base wallet with USDC in its Circle Gateway balance, used to automatically pay for paid tool calls via x402. Not needed for free tools like report_outcome. (example: `<your-base-wallet-private-key>`)

Note: Hosted-service thin client for https://402sentinel.com. Paid calls cost $0.002 to $0.02 and are paid automatically in USDC via x402. Free tools are available without CLIENT_PRIVATE_KEY.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Hosted-service thin client for https://402sentinel.com. Paid calls cost $0.002 to $0.02 and are paid automatically in USDC via x402. Free tools are available without CLIENT_PRIVATE_KEY.

Tools (6)

assess_counterparty

Returns a risk score, decision, confidence/coverage, and a recommended wallet spending policy for a seller/counterparty

assess_counterparty_deep

Same as assess_counterparty but scans more on-chain history for a deeper assessment

recommend_policy

Returns a decision and wallet-ready spending policy without the full assessment output

report_outcome

Reports the delivery/payment outcome after paying to improve future reliability scoring

firewall

Checks whether the current payment should proceed, detecting fraudulent routing, drain velocity, overcharge, and injection-sourced instructions

firewall_record

Seeds the agent's payment history so the firewall has a behavioral baseline

Environment variables

CLIENT_PRIVATE_KEYrequiredBase wallet private key used to sign and pay for paid MCP calls from a wallet with USDC in its Circle Gateway balance

Packages

@kaditang/402sentinel-mcp

npmv0.7.1transport: stdio

Details

Language: JavaScript
Released: Jun 10, 2026
Last commit: May 31, 2026
Registry name: io.github.kaditang/402sentinel-mcp

Related Servers

Edgartools

Open-source SEC EDGAR toolkit — 11 tools, 7 prompts, every filing type. No API key required.

2.6k

edgar.tools SEC Intelligence

SEC filing intelligence — insider sentiment, material events, financial ratios, disclosure search.