PathGuard MCP server
Commit Nov 6, 2026Lets AI agents inspect crypto addresses and transactions for scam risks and mistakes before sending funds.
Also known as Utee/pathguard-mcp, pathguard-mcp
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 6, 2026
- License
- —
What is PathGuard MCP?
PathGuard lets AI agents inspect crypto addresses and transactions for scam risks and mistakes before sending funds. It exposes 6 tools, such as check_transaction, preflight_transaction, check_transactions_batch.
Summary generated from the project's README
About PathGuard MCP server
PathGuard MCP provides a safety layer for AI agents interacting with cryptocurrency by inspecting addresses and transactions for potential scams or errors. It acts as an analysis-only interface that does not sign, broadcast, or transfer any funds. This ensures that the agent can verify the safety of a destination before a user commits to a transaction.
Developers can deploy this as a local stdio server for clients like Claude Desktop, Claude Code, Gemini CLI, Grok CLI, Cursor, or Codex by providing a PATHGUARD_API_KEY. For remote setups, such as ChatGPT with Developer Mode, it offers a Streamable HTTP endpoint protected by OAuth. This allows users to connect their existing PathGuard accounts without exposing raw API keys to the AI client.
The server includes specific tools like check_transaction for single inspections, preflight_transaction for a full risk assessment, and check_transactions_batch which can process up to 1,000 items at once. It also allows users to report suspected scam addresses and monitor their monthly scan usage via get_usage_status.
Written from the project's README. Every use case is checked against a quote from it.
How to install PathGuard MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall PathGuard MCP in Claude Code
$ claude mcp add --transport http pathguard-mcp https://pathguard-v2.up.railway.app/mcpInstall PathGuard MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pathguard-mcp": {
"url": "https://pathguard-v2.up.railway.app/mcp"
}
}
}Install PathGuard MCP in VS Code
.vscode/mcp.json
{
"servers": {
"pathguard-mcp": {
"type": "http",
"url": "https://pathguard-v2.up.railway.app/mcp"
}
}
}Install PathGuard MCP in VS Code CLI
$ code --add-mcp '{"name":"pathguard-mcp","type":"http","url":"https://pathguard-v2.up.railway.app/mcp"}'Install PathGuard MCP in Codex
$ codex mcp add pathguard-mcp --url https://pathguard-v2.up.railway.app/mcpInstall PathGuard MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.pathguard-mcp] url = "https://pathguard-v2.up.railway.app/mcp"
Install PathGuard MCP in Gemini CLI
$ gemini mcp add -s user --transport http pathguard-mcp https://pathguard-v2.up.railway.app/mcpInstall PathGuard MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"pathguard-mcp": {
"url": "https://pathguard-v2.up.railway.app/mcp",
"type": "http"
}
}
}PathGuard MCP tools 6
Detected from the READMEcheck_transactionpreflight_transactioncheck_transactions_batchreport_scam_addressget_usage_statusget_profile
| check_transaction | — | |
| preflight_transaction | — | |
| check_transactions_batch | — | |
| report_scam_address | — | |
| get_usage_status | — | |
| get_profile | — |
Configuration
PATHGUARD_API_KEY
| Name | Description | |
|---|---|---|
| PATHGUARD_API_KEY | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableutee/pathguard-mcp is public and reachablegithub.com/utee/pathguard-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-06github.com/utee/pathguard-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeEndpoint did not answer initialize: HTTP 404Finding
README
View on GitHubpathguard-mcp
PathGuard MCP lets MCP-compatible AI agents check crypto transactions for scams and mistakes directly in conversation. It supports local MCP clients such as Claude Desktop, Claude Code, Gemini CLI, Grok CLI, Cursor, and Codex, plus remote Streamable HTTP deployments.
Listed on the official MCP Registry as
org.cieltech.pathguard/pathguard.
The production MCP server is a thin, authenticated interface to PathGuard's transaction-safety API. PathGuard analyzes transactions before a send; it does not sign, broadcast, or transfer funds.
Production MCP
Remote Streamable HTTP endpoint:
https://api.pathguard.cieltech.org/mcp/
Remote clients use OAuth to connect an existing PathGuard account. During authorization, PathGuard verifies the user's existing API key. The API key is not exposed to the AI client or returned through MCP.
For local/stdio use, the API key is supplied to the local server process through PATHGUARD_API_KEY.
Install
The package is currently installed directly from this public repository and is not published to PyPI yet.
git clone https://github.com/Utee/pathguard-mcp.git
cd pathguard-mcp
python -m pip install .
For development, use an editable install:
python -m pip install -e .
Requires Python 3.10+ and mcp >= 2.0.
Get an API key
Create a PathGuard account and API key from the PathGuard API documentation.
Keep your API key private. Do not commit it to GitHub or expose it in browser-side code.
Local MCP clients
For local clients, the server uses stdio and authenticates to the PathGuard API with PATHGUARD_API_KEY.
Claude Desktop
Add this to your Claude Desktop config:
{
"mcpServers": {
"pathguard": {
"command": "pathguard-mcp",
"env": {
"PATHGUARD_API_KEY": "pg_your_key_here"
}
}
}
}
Claude Code
claude mcp add --transport stdio pathguard -- pathguard-mcp
Set PATHGUARD_API_KEY in the environment that starts Claude Code.
Gemini CLI
{
"mcpServers": {
"pathguard": {
"command": "pathguard-mcp",
"env": {
"PATHGUARD_API_KEY": "pg_your_key_here"
}
}
}
}
Grok CLI
export PATHGUARD_API_KEY=pg_your_key_here
grok mcp add pathguard -- pathguard-mcp
Codex, Cursor, VS Code, and other local MCP clients
Use the same stdio server definition as the Claude Desktop example. The exact configuration location varies by client.
Remote clients
For remote clients, use the production OAuth-protected Streamable HTTP endpoint shown above. Never put a PathGuard API key in browser-side configuration.
ChatGPT
In a ChatGPT workspace with Developer Mode enabled, create a custom MCP app and provide:
https://api.pathguard.cieltech.org/mcp/
Choose OAuth authentication. ChatGPT will use the PathGuard authorization flow to connect an existing PathGuard account.
The authorization flow verifies the user's PathGuard API key, then issues OAuth credentials for the MCP connection. The raw PathGuard API key is not returned to ChatGPT.
Available tools
| Tool | What it does |
|---|---|
check_transaction |
Inspect one crypto destination and optional amount for PathGuard risk signals. |
preflight_transaction |
Run the full pre-send check and return ALLOW, REVIEW, or BLOCK. |
check_transactions_batch |
Check up to 1,000 transactions and return a compact risk summary or full results. |
report_scam_address |
Record a suspected scam address when the user explicitly asks to report it. |
get_usage_status |
View the connected account's plan and monthly scan usage. |
get_profile |
Identify the PathGuard account represented by the OAuth connection. |
Tool safety boundary
PathGuard MCP is analysis-only. Its tools do not:
- sign transactions;
- broadcast transactions;
- transfer funds;
- request private keys or seed phrases;
- replace your application's authorization controls.
A BLOCK result is a PathGuard safety signal. The wallet, application, or agent remains responsible for authorization, signing, and final transaction execution.
Batch checking
check_transactions_batch supports up to 1,000 items.
By default it returns a compact summary containing:
- total items;
- processed items;
- ALLOW / REVIEW / BLOCK counts;
- maximum risk score;
- flag counts;
- a sample of flagged transactions.
Use detail_level="full" when individual results are required.
Security
- Keep API keys server-side and private.
- Use HTTPS for remote deployments.
- OAuth protects the production remote MCP connection.
- The production MCP server maps the authenticated OAuth subject to an existing PathGuard account.
- Internal server-to-server authentication is not exposed as an MCP argument or model-visible credential.
- Never commit API keys, production credentials, or local
.envfiles.
Full API reference
See the PathGuard API documentation for endpoint schemas, rate limits, pricing, and risk-flag information.
PathGuard MCP: https://pathguard.cieltech.org/mcp
Moving existing connections to the custom domain
Remote OAuth clients previously connected to the Railway address must create a new connection using https://api.pathguard.cieltech.org/mcp/ and authorize again with their existing PathGuard API key. The old Railway endpoint is in maintenance; imported OAuth records do not automatically update a client's saved server URL or issuer.
For local stdio clients, update your checkout (git pull and python -m pip install .) or explicitly set PATHGUARD_API_BASE=https://api.pathguard.cieltech.org alongside PATHGUARD_API_KEY, then restart the MCP client. Existing API keys remain valid.
Optional token and deposit details
Existing tool names are unchanged. check_transaction and each check_transactions_batch item accept an optional transfer object:
{"address":"TAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","chain":"TRON","transfer":{"token":"USDC","token_kind":"token","network":"TRON","destination_type":"exchange","exchange":"Kraken"}}
Exact networks: ETHEREUM, BASE, ARBITRUM, OPTIMISM, BSC, POLYGON, BITCOIN, SOLANA, TRON, XRPL, STELLAR. The address family remains EVM/BTC/SOL/TRON/XRP/XLM. Optional transfer fields include token_contract, recipient_network, memo and memo_required. Use native only for an actual native coin, not a wrapped token. The response includes compatibility reasons and official-source review dates where available. Selected exchange rules cover Kraken, Coinbase consumer accounts and Binance.com; Coinbase Exchange, Coinbase Wallet, Binance.US, unverified combinations and personal wallet acceptance remain Unknown—confirm with the recipient. OFAC screening covers EVM/BTC/SOL/TRON only. Only selected USDC/USDT mainnet identifiers are compared with dated issuer references. The actual wallet transaction, memo account ownership and live deposit availability are not verified.
Update your GitHub-installed package and restart your MCP client to refresh its tool schemas. This source update does not publish a package release. The hosted OAuth MCP at https://api.pathguard.cieltech.org/mcp/ also extends its existing preflight_transaction tool with the same transfer object. Existing address-only calls still work.
Issuer-reference token identity
Pass the contract/mint from the sending wallet's asset details in transfer.token_contract. Mainnet coverage: USDC on Ethereum, Base, Arbitrum One, OP Mainnet, Polygon PoS and Solana; USDT on Ethereum, TRON and Solana. References come from Circle and Tether and expire after seven days unless reviewed again.
Read compatibility.token_identity for matched, mismatch or unknown, source dates and limitations. Matched is an identifier comparison, not proof of recipient acceptance or which asset a wallet will actually send. A mismatch may represent a legitimate wrapped or bridged asset, not necessarily a scam. Missing, stale, malformed or uncovered identifiers remain unknown. The existing tool names and arguments are unchanged.
PathGuard MCP questions
How do I add PathGuard MCP to Claude Code?
Run claude mcp add --transport http pathguard-mcp https://pathguard-v2.up.railway.app/mcp in your terminal. Add --scope user to make it available in every project.
How do I add PathGuard MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does PathGuard MCP provide?
It exposes 6 tools, including check_transaction, preflight_transaction, check_transactions_batch, report_scam_address, get_usage_status.
Can PathGuard sign or transfer my crypto funds?
No, PathGuard is an analysis-only tool and does not have the ability to sign, broadcast, or transfer any funds.
How many transactions can I check at once?
You can use the batch checking tool to inspect up to 1,000 transactions in a single request.
What authentication methods are supported?
Local clients use an API key via an environment variable, while remote clients use OAuth to connect an existing PathGuard account.