SentriAgent API Docs

Overview

SentriAgent exposes 4 MCP tools and 4 matching HTTP endpoints. All paid endpoints require x402 payment via OKX Agent Payments Protocol.

Tools

1. `assess_token`

Get a 0-100 risk score for a token contract address. Fuses 3 signal sources (OKX onchainos-mcp, GoPlus, De.Fi) into a single verdict with category (SAFE / LOW_RISK / MEDIUM / HIGH_RISK / CRITICAL) and recommendation.

Parameters:

Name	Type	Description
`chain`	enum	One of: ethereum, bsc, polygon, arbitrum, base, xlayer, solana
`address`	string	Token contract address (0x... for EVM, base58 for Solana)

Returns:

{
  "score": 87,
  "level": "LOW_RISK",
  "proceed": true,
  "recommendation": "PROCEED: Low risk, normal precautions apply.",
  "signals": { "okx": {...}, "goplus": {...}, "defi": {...} },
  "latencyMs": 847,
  "timestamp": "2026-07-10T00:00:00Z",
  "sources": ["OKX onchainos-mcp", "GoPlus Security", "De.Fi"]
}

2. `assess_wallet`

Risk profile for a wallet address. Checks rug history, sanctions, exploit exposure, mixer usage.

3. `assess_tx`

Pre-flight transaction simulation. Combines risk verdict of target contract + sender wallet, returning a single decision before broadcast.

4. `bundle_assess`

Bulk assess up to 5 tokens in one call. 20% cheaper than individual calls. Returns array of verdicts + average score + allSafe boolean.

Payment (x402)

All endpoints return HTTP 402 with payment challenge if no valid payment proof is attached.

Agent flow:

Call endpoint without payment → receive 402 + challenge
Sign x402/APP payment using agent's wallet
Retry with headers: X-Payment-Id, X-Payment, X-Payment-Tx
Receive risk verdict

HTTP API

Same tools available as REST endpoints for non-MCP clients:

POST /v1/assess-token    { chain, address }
POST /v1/assess-wallet   { chain, address }
POST /v1/assess-tx       { chain, from, to, data?, value? }
POST /v1/bundle-assess   { tokens: [{chain, address}, ...] }

OpenAPI

See /openapi.json for the full OpenAPI 3.0 spec.

Source & License

MIT licensed · github.com/Donyemiight/sentriagent