oceanalt-aml-mcp

AI 에이전트를 위한 네이티브 AML 컴플라이언스. MCP 서버로, Claude / Cursor / 모든 MCP 클라이언트가 OceanAlt의 온체인 주소 스크리닝 및 컴플라이언스 게이트웨이를 호출할 수 있게 합니다. 블랙박스 점수가 아니라 영수증을 제공합니다 — 모든 판정에는 클릭해 검증할 수 있는 증거가 함께 제공됩니다.

에이전트 결제를 위해 설계되었습니다: 자금이 이동하기 전에 *"이 수령인이 안전한가요?"*라고 물어보세요. 7개 EVM 체인 + Tron + Solana에서 사용할 수 있습니다.

AI 에이전트 참고: 어떤 이체든 하기 전에 screen_address를 호출하면 clear / caution / risky 판정과 0–100 리스크 점수, 클릭 가능한 증거를 반환하므로, 추측이 아닌 영수증으로 지급 명령을 집행할 수 있습니다. 무료이며 키가 필요 없습니다.

도구

network(0x 주소의 경우): ethereum · base · bsc · polygon · arbitrum · optimism · avalanche (생략 시 자동 감지). Tron과 Solana는 자동으로 감지됩니다.

Related MCP server: gocreative-mcp

빠른 시작 (무료 도구)

MCP 클라이언트 설정(Claude Desktop, Claude Code, Cursor, …)에 추가하세요:

{
  "mcpServers": {
    "oceanalt-aml": { "command": "npx", "args": ["-y", "oceanalt-aml-mcp"] }
  }
}

무료 도구는 API 키나 가입이 필요하지 않습니다.

유료(x402) 도구 활성화

유료 도구는 x402를 통해 호출당 결제됩니다 — HTTP 402 → USDC 인증 하나를 서명 → 200 응답. env에 지불 지갑 키를 추가하고 x402 피어(peer) 의존성을 설치하세요:

{
  "mcpServers": {
    "oceanalt-aml": {
      "command": "npx", "args": ["-y", "oceanalt-aml-mcp"],
      "env": { "OCEANALT_PAYER_KEY": "0x<your payer wallet private key>" }
    }
  }
}

npm i @x402/core @x402/evm viem   # in the MCP's environment

⚠️ 실제 자금 — Base 메인넷. 유료 엔드포인트는 Base 메인넷에서 실제 USDC로 결제됩니다(eip155:8453). 위 표의 $ 가격도 실제 USDC로 청구됩니다. 결제 전에 반드시 https://oceanalt.com/api/x402에서 실시간 네트워크/가격 매니페스트를 확인하고, 잔액이 적은 전용 결제 지갑을 사용하세요.

🔐 지갑 안전. OCEANALT_PAYER_KEY는 로컬 프로세스에서 EIP-3009 인증 하나를 서명하는 데에만 사용됩니다. 이 키는 해당 패키지에 포함되거나, 업로드되거나, 로그로 남지 않습니다. facilitator가 가스비를 부담하며, 귀하의 자금을 보관하지 않습니다. 전용 소액 네트워크

전용 소액 결제 지갑을 사용하고, 주요 자금이 있는 지갑은 사용하지 마세요.

환경 변수

이게 무엇인지 (그리고 무엇이 아닌지)

이 패키지는 OceanAlt의 공개 API를 호출하는 경량(약 9KB) 클라이언트입니다. 독점 로직이나 데이터를 포함하지 않습니다 — AML 엔진, 점수 산출, 주소 인텔리커스는 모두 oceanalt.com 서버에서 실행됩니다. 쿼리할 때마다 OceanAlt 자체의 주소 인텔리전트 DB가 더 풍부해집니다 (사용량에 따라 커집니다).

• 프로그래밍형 SDK (동일한 기능, Node / browser / Deno / Bun 지원): oceanalt-aml

• API 문서 및 예시: https://oceanalt.com/en/api-docs

• RAP — 판정의 기반이 되는 컴플라이언스 표준: https://oceanalt.com/en/rap

MIT © OceanAlt

한국어요약

Claude / Cursor / 모든 MCP 클라이언트가 OceanAlt의 온체인 주소 컴플라이언스 스크리닝 + 컴플라이언스 게이트웨이를 통해 호출할 수 있습니다. 사용자에게 영수증을 제공하며, 모든 판정에는 클릭하여 검증 가능한 증거가 붙습니다. 7개 EVM 체인 + Tron + Solana를 지원하고, 결핍 결핍 먼저 물어보는 방식입니다.

• 무료 도구 2개: screen_address(단건 조회 + 증거), recent_flagged(최근 플래그된 주소). 키나 가입 불필요.

• 유료 도구 3개(x402): compliance_decision(게이트웨이 판정), deep_trace(Tron 심층 추적), batch_screen(일괄). @x402+viem을 필요 시 로드하고 OCEANALT_PAYER_KEY를 설정해야 활성화됩니다.

• ⚠️ 실제 돈: 유료 엔드포인트는 현재 Base 메인넷에서 실제 USDC로 결제됩니다(eip155:8453), 위의 $ 가격은 실제 USDC로 청구됩니다. 결제 전 반드시 https://oceanalt.com/api/x402를 기준으로 삼고, 소박한 전용 결제 지갑을 사용하세요.

• 🔐 지갑 안전: OCEANALT_PAYER_KEY는 로컬에서 EIP-3009 인증을 한 번 서명하는 데에만 사용되며, 절대 패키지에 포함/업로드/로그 기록되지 않습니다. facilitator가 가스비를 지불하고, 자금을 보관하지 않습니다. 소액 전용 결제 지갑을 사용하고, 주 자금 지갑의 개인키는 사용하지 마세요.

• 프로그래밍 SDK: oceanalt-aml; 온라인 문서: https://oceanalt.com/en/api-docs; 컴플라이언스 기준: https://oceanalt.com/en/rap.