sumsub-manage-wallet-address-book — Claude Code skill
Registers an organisation’s crypto wallets in Sumsub so Travel Rule requests can use stored ownership data. It covers bulk imports and applicant-linked payment methods.
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a claude-codeWhat sumsub-manage-wallet-address-book does
This skill sends organisation-controlled addresses to Sumsub’s Wallet Address Book with POST /resources/kyt/walletAddress/import. For a known applicant, it uses POST /resources/api/applicants/{applicantId}/payments to add one address as a cryptoWallet payment method. The second route links the wallet to a person.
It includes a JSON payload builder plus shell helpers for the import and payment-method requests. A bulk request can contain up to 10 000 entries and may return both accepted and rejected records, so errorCount and the reported errors need to be inspected. The flow uses sandbox SUMSUB_APP_TOKEN and SUMSUB_SECRET_KEY; bulk import also requires the token subject to have the admin role.
If the organisation is not linked to a VASP, the import returns HTTP 404 and retrying will not fix it. The tenant also needs the TRAVEL_RULE entitlement, and production App Tokens are rejected by the helper unless an override is set.
What it helps with
- bulk-import organisation-controlled wallet addresses
- link one crypto wallet to an applicant
- build a valid Wallet Address Book payload
- inspect rejected entries after a partial import
- reduce manual handling of Travel Rule requests
Example prompts for the agent
- Import our organisation’s wallet addresses into Sumsub’s Wallet Address Book and report rejected entries.
- Register the applicant’s crypto wallet as a payment method for
<applicantId>. - Check the
TRAVEL_RULEentitlement, build the payload fromwallets.yaml, and submit the addresses.
How to install sumsub-manage-wallet-address-book
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a claude-code2Manually: put the files in place
~/.claude/skills/sumsub-manage-wallet-address-book/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sumsub-manage-wallet-address-book/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a codex2Manually: put the files in place
.agents/skills/sumsub-manage-wallet-address-book/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a cursor2Manually: put the files in place
.cursor/skills/sumsub-manage-wallet-address-book/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sumsub/agent-skills sumsub-manage-wallet-address-book2Manually: put the files in place
.github/skills/sumsub-manage-wallet-address-book/SKILL.md1Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a gemini-cli2Platform CLI
gemini skills install https://github.com/sumsub/agent-skills --path skills/sumsub-manage-wallet-address-bookManually: put the files in place
.devin/skills/sumsub-manage-wallet-address-book/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sumsub-manage-wallet-address-book
How do I install sumsub-manage-wallet-address-book in Claude Code?
Run npx skills add sumsub/agent-skills --skill sumsub-manage-wallet-address-book -a claude-code. The skill file will be at ~/.claude/skills/sumsub-manage-wallet-address-book/SKILL.md.
What does sumsub-manage-wallet-address-book do?
It imports organisation-controlled crypto addresses into Sumsub or attaches one wallet to a specific applicant. Sumsub can then use those records when handling related Travel Rule requests.
What is required before importing wallet addresses?
Use a sandbox SUMSUB_APP_TOKEN with its paired SUMSUB_SECRET_KEY. The organisation must be linked to a VASP, the tenant needs TRAVEL_RULE, and the import token needs the admin role.
