# Onyx AML

> Onyx AML is a paid MCP server for finance and payments. Crypto address screening for agents: sanctions, stablecoin blacklists and scam lists. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://onyxprotocol.trade/en/agents
- **MCP Registry name:** trade.onyxprotocol/onyx-aml
- **Categories:** finance and payments, security
- **Listing updated:** 2026-11-16

## About

An agent about to send funds needs to know who is on the other side, and this endpoint answers in one call that the agent pays for itself. A request without a key gets an HTTP 402 in the x402 format; an agent with an x402 client signs a USDC authorisation on Base and gets the result in the same request. Runtimes without one can send USDC or USDT on Base, claim an API key for the paying address, and pass it as X-Api-Key.

A screening returns a risk band (red, amber, green or gray) with the reasons. Checks cover USDT blacklists read from contracts on Ethereum and TRON, USDC blacklists on six chains, freeze authority on Solana, Chainalysis oracle sanctions on six EVM chains plus OFAC SDN for TRON and Solana, open scam databases and community reports, and behavioural facts such as address age and fan-in.

Other purchasable calls include a policy verdict of allow, review or deny, batch screening of up to 100 addresses, a lookalike and wrong-chain check, multi-hop fund tracing and a signed webhook when an address becomes toxic. The operator says it holds no keys or balances.

## Features

- **Pay-per-call access:** Agents discover the price by receiving a 402 and settle in USDC on Base without an account.
- **Risk band:** Each address gets a red, amber, green or gray zone with named reasons.
- **Issuer blacklists:** USDT and USDC blacklists are read straight from chain contracts.
- **Sanctions screening:** Chainalysis oracle data across six EVM chains plus OFAC SDN lists for TRON and Solana.
- **Batch screening:** Up to 100 addresses can be checked in one call for mass payouts.
- **Lookalike detection:** Flags address-poisoning lookalikes and addresses that behave differently across chains.
- **Freeze webhook:** A signed webhook fires when an address becomes toxic.

## Good for

- Screen a counterparty before an agent sends a stablecoin payment
- Check a payout list of up to 100 addresses
- Get an allow, review or deny decision against your own policy
- Detect address-poisoning lookalikes planted in transaction history
- Trace where incoming funds came from

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http onyx-aml https://onyxprotocol.trade/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://onyxprotocol.trade/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "onyx-aml": {
      "url": "https://onyxprotocol.trade/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "onyx-aml": {
      "type": "http",
      "url": "https://onyxprotocol.trade/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "onyx-aml": {
      "serverUrl": "https://onyxprotocol.trade/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "onyx-aml": {
      "type": "http",
      "url": "https://onyxprotocol.trade/mcp"
    }
  }
}
```

## FAQ

### How does an agent pay?

Through x402: the agent signs a USDC authorisation on Base and retries the request, or sends funds and claims a key for the paying address.

### Does it need an account or API key application?

No account is needed. A key is issued once per paying address after a transfer.

### Does the operator hold my funds?

The operator says payments go to its own address and that the service holds no private keys or balances for users.

### What does it check?

Issuer blacklists, sanctions lists, scam databases and behavioural patterns such as address age and exchange attribution.

### Is Onyx AML free?

No. Onyx AML is a paid product.

### How do I add Onyx AML to Claude Code?

Run this command in your terminal: claude mcp add --transport http onyx-aml https://onyxprotocol.trade/mcp

### What are the best alternatives to Onyx AML?

The closest alternatives to Onyx AML are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/onyx-aml
