Zerion Hosted MCP

MCP金融服务

提供方 zeriontech

金融服务 未标注 API Key 社区 / 第三方

Zerion MCP let's your agent analyze EVM and Solana wallets and summarize total portfolio value, top holdings, DeFi positions, recent transactions, PnL and more.

一句话选型结论

按资料字段整理

Zerion Hosted MCP 属于金融服务类 MCP 服务器,传输方式未标注,API Key,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类金融服务 传输方式未标注 鉴权API Key 部署方式支持远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

金融服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
行情与财务数据

查行情、财报、汇率等金融数据。

支付与账务查询

查订单、账单与交易流水。

风控与核验

做身份、信用与风险信息核验。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在金融服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Zerion Hosted MCP当前 未标注 未标注 支持远程部署 无 2026-05-17
Alpaca MCP 62 stdio · 本地进程 支持远程部署 有 2026-05-18
OpenNews MCP 11 stdio · 本地进程 支持远程部署 有 2026-05-17
MCP Server 273df76d 未标注 stdio · 本地进程 本地部署 有 2026-05-17
tradingview-mcp 未标注 stdio · 本地进程 本地部署 有 2026-04-19
goat (Goat SDK) 未标注 未标注 未标注 无 2026-05-17

服务器档案

金融服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方zeriontech上游标注的维护方 zeriontech
分类金融服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

29.2 KB
来自项目仓库与上游目录的原文,未做删改

Zerion CLI

CLI for Zerion Wallet. Analyze wallets, sign, swap, and bridge on-chain with agent-managed wallets across EVM chains and Solana, all from the command line. Wallet management is built on the Open Wallet Standard.

> [!NOTE]
> Alpha Preview — This CLI is under active development. Commands, flags, and output formats may change or be removed without notice between releases. Do not depend on current behavior in production workflows.

Installation

Set up everything in one command (install CLI globally, configure your API key, and add skills to your coding agents):```bash
npx zerion-cli@latest init


- authenticates in the browser via dashboard.zerion.io and saves the key for you — no copy/paste
- detects your coding agent (Claude Code, Cursor, Codex, Gemini) and installs the Zerion skills globally
- add `-y` to skip the prompts: browser login, then every skill installed

On a remote or headless host, add `--no-open` to print the authorize URL instead of opening a browser. Without a terminal (CI, piped), `init` prints API-key instructions rather than waiting on a browser login — set `ZERION_API_KEY` there instead.

Or just install the CLI without setup:```bash
npm install -g zerion-cli

The CLI is available as either zerion or zerion-cli — both run the same binary.

Requires Node.js 22.12+ (or 20.19+ on Node 20). Older versions exit with an unsupported_node error.

Agent skill

One skill, zerion, under ./skills/zerion/ — follows the agentskills.io open standard. All capabilities and partner integrations live as nested files that load on demand (progressive disclosure), so a single install + single picker entry exposes everything below.

Capabilities (skills/zerion/capabilities/)

File What it covers
analyze.md Portfolio, positions, history, PnL, token search, watchlist (read-only; supports x402 / MPP)
trading.md Swap, bridge, send tokens (on-chain actions; needs API key + agent token) — plus the signing-route model: local signing vs. web-app handoff for human review
bundle.md Queue several actions into one signing session / one human review (--prepare + bundle)
sign.md Off-chain signing — sign-message (EIP-191 / raw), sign-typed-data (EIP-712)
wallet.md Wallet management — create, import, add read-only, list, fund, review threshold, backup, export-key, delete, sync
agent-management.md Agent tokens + policies (the autonomous-trading primitives)
swap-0x.md Token swaps via 0x API v2 — AllowanceHolder, Permit2, and Gasless flows across 20+ EVM chains
defi-exit.md Exit DeFi positions — withdraw, unstake, redeem, claim, repay — then convert the proceeds through swap / bridge

Partner integrations (skills/zerion/partners/)

Ecosystem partners that combine their product with the Zerion CLI. See partner-skill-creator.md to contribute one. Loaded only when the user names the partner.

File What it covers Partner
bankr.md Twitter/X-native trading bot patterns Bankr
lifi-earn.md Cross-chain yield routing Li.Fi
monad-addresses.md Canonical Monad mainnet contract addresses for zerion agent create-policy --allowlist lockdown Monad
moonpay-onramp.md Buy crypto with card or bank transfer via MoonPay, then trade with Zerion MoonPay
moonpay-iron.md USD bank-wire to Iron virtual account (IBAN/ACH) → USDC → DCA via Zerion MoonPay
moonpay-predict.md Trade prediction markets (Polymarket, Kalshi) via MoonPay CLI MoonPay
sendai-ideas.md Crypto idea discovery, validation, competitive landscape, DeFi TVL research SendAI (MIT)
somnia-blockchain.md Somnia L1 reference — network info, gas model, deployment guidance Somnia
somnia-reactivity.md Somnia Reactivity — event-driven pub/sub, WebSocket + Solidity handlers Somnia
trails-crosschainswap.md Cross-chain swaps to/from Polygon via Trails SDK (Widget / Headless / API) Trails
trails-deposit.md Bridge + DeFi vault deposit on Polygon in one intent (Aave, Morpho, ERC-4626) Trails
umbra-privatetxn.md Private (stealth-address) transfers Umbra
uniswap-lp.md Liquidity position management Uniswap
uniswap-x402.md Swap with x402 pay-per-call Uniswap
vaultsfyi-*.md Deposit, market intel, rebalance, risk monitor, strategist, watchlist, yield optimizer Vaults.fyi
yellow-settlement-room.md Multiparty off-chain settlement rooms Yellow
consolidate.md Sweep all tokens on a chain into one target Zerion
treasury-liquidation.md Drain a wallet across all chains, and/or sweep a whole multi-chain portfolio into one token Zerion

Install via zerion CLI (recommended)```bash

zerion setup skills


Installs globally across all detected coding agents. Use `--agent ` to scope to one agent, or `-g` to force a global install.

### Install via Claude Code```text
/plugin marketplace add zeriontech/zerion-ai
/plugin install zerion-agent@zerion

Install via Cursor

Install zerion-agent from the Cursor Marketplace: open Customize in the sidebar, find Zerion, then Install and pick project or user scope.

The plugin ships the zerion skill plus the hosted Zerion API docs MCP server (https://developers.zerion.io/mcp), so the agent can look up endpoint reference without leaving the editor.

Install via OpenAI Codex CLI```sh

codex plugin marketplace add zeriontech/zerion-ai


Then run `/plugins` in Codex, choose the `zerion` marketplace, and install `zerion-agent`.

### Install via Gemini CLI```bash
gemini extensions install https://github.com/zeriontech/zerion-ai

Install via agentskills.io (works with 20+ popular agents)```bash

npx skills add zeriontech/zerion-ai


Auto-detects installed agents. Flags: `-g` (user-wide), `-a ` (target one host), `-y` (non-interactive). Full ecosystem: .

## How to use

After install, ask the agent in natural language.

### Wallet analysis

> Analyze the wallet `vitalik.eth`. Summarize total portfolio value, top 5 holdings, and recent transactions.

> What's the PnL on `0xFe89Cc7Abb2C4183683Ab71653c4cCd1b9cC194e` over the last 30 days?

> Show DeFi positions (lending, staking, LP) for my default wallet.

### Trading

> Swap 100 USDC to ETH on Base.

> Bridge 50 USDC from Arbitrum to Optimism.

> Send 0.1 ETH on Base to `vitalik.eth`.

> Sell my USDC and DAI on Base into ETH — one signing session for both.

### Human review

> Ask me before anything over $500 from `bot-1`.

> Track my Ledger address as `cold` and swap 1 ETH to USDC from it — I'll sign in the browser.

### Wallet management

> Create a new encrypted wallet called `bot-1`.

> Set up an agent token for `bot-1` that's allowed to swap on Base only, with a 7-day expiry.

> List my wallets and which agent tokens are active.

### Signing

> Sign the EIP-712 message in `typed.json` using my `bot-1` wallet.

The agent reaches for the `zerion` skill, which routes by task to the right nested file under `capabilities/` or `partners/`. Progressive disclosure means only the matching capability doc loads — context stays clean. A "create wallet, set up agent token, then swap" flow Reads `capabilities/wallet.md` → `capabilities/agent-management.md` → `capabilities/trading.md` in sequence.

## Manual setup, agent execution

Zerion CLI splits into two surfaces, by design.

- **Wallet management and agent token setup are manual.** `wallet create`, `import`, `backup`, `export-key`, and `delete` all prompt for a passphrase. `wallet sync` emits a QR code you scan with the Zerion app. `agent create-token` mints a scoped trading credential bound to a specific wallet, and `agent create-policy` attaches the rules it has to obey — allowed chains, expiry, transfer/approval gates, contract allowlists. The sibling admin commands (`agent list-tokens`, `use-token`, `revoke-token`, `list-policies`, `show-policy`, `delete-policy`) are also gestures you make yourself. No key material moves and no spending credential widens without you in the loop. For CI and headless servers, `agent create-token` accepts `--passphrase-file ` (file must be mode `0600`) so token issuance can be scripted without an interactive TTY — see `capabilities/agent-management.md`.
- **Analysis, signing, trading, and discovery are for agents.** `analyze`, `portfolio`, `positions`, `history`, `pnl`, `sign-message`, `sign-typed-data`, `swap`, `bridge`, `send`, `swap tokens`, `search`, `chains`, `wallet list`, `wallet fund`, and `watch list` emit JSON to stdout, structured errors to stderr, and skip confirmation dialogs. Once an agent token is configured, signing and trading fire immediately — the token authorizes operations on behalf of the wallet without a passphrase prompt.
- **You can put yourself back in the loop, per wallet.** Unattended signing is the default, not the only mode: a **read-only wallet** (`wallet add` — an address with no keys here) or a **review threshold** (`wallet set-review-threshold`) sends the affected transactions to the Zerion web app for a human to review and sign in a browser, instead of auto-signing. Agent policies say what the token may never do; the review threshold says what you want to be asked about. See Signing routes.

Setup gestures (`init`, `setup skills`, `config set/unset/list`, `watch` add/remove) are one-time configuration steps you run yourself before automation takes over.

The split is the point. You stage by hand once — create or import a wallet, set a passphrase, mint an agent token, attach a policy — then hand the agent token to an automation that can only do what the policy allows. Treat agent tokens like API keys with spending power; use agent policies to scope them down to specific chains, addresses, or expiry windows.

## Authentication

Three options. The CLI auto-detects which is active.

### A) API key (recommended)

Get a key at **dashboard.zerion.io** — it's free and takes a minute. Keys begin with `zk_`.

The fastest way is **browser login** — like `claude` or `gh auth login`, it opens the dashboard, you approve, and the key is captured over a local loopback redirect and saved to config. The key never leaves your machine.```bash
zerion login              # pick browser login, paste a key, or pay-per-call
zerion login --browser    # go straight to browser authentication

Or set / persist a key manually:```bash
export ZERION_API_KEY="zk_..." # per-session
zerion config set apiKey zk_... # persisted to ~/.zerion/config.json


- HTTP Basic Auth
- Required for analysis and trading commands (analysis can also use x402 / MPP pay-per-call instead — see options B and C)

### B) x402 pay-per-call

**No API key needed.** Pay $0.01 USDC per request via the x402 protocol. Supports EVM (Base) and Solana.

> Pay-per-call applies to analytics commands only (`portfolio`, `positions`, `history`, `pnl`, `analyze`). Trading commands always use an API key.```bash
export WALLET_PRIVATE_KEY="0x..."     # EVM (Base) — 0x-prefixed hex
export WALLET_PRIVATE_KEY="5C1y..."   # Solana — base58 encoded keypair

zerion analyze 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --x402
# or enable globally:
export ZERION_X402=true

Both chains simultaneously:```bash
export EVM_PRIVATE_KEY="0x..."
export SOLANA_PRIVATE_KEY="5C1y..."
export ZERION_X402_PREFER_SOLANA=true # optional, prefers Solana when both set


### C) MPP pay-per-call

**No API key needed.** Pay $0.01 USDC per request via the MPP protocol on Tempo. EVM only.```bash
export WALLET_PRIVATE_KEY="0x..."   # EVM key with USDC on Tempo
# or use a dedicated key:
export TEMPO_PRIVATE_KEY="0x..."

zerion portfolio 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --mpp
# or enable globally:
export ZERION_MPP=true

Commands

Every command supports --help for full flag documentation. Run zerion --help for the top-level command list.

Wallet Analysis

Read-only. Supports --x402 and --mpp for pay-per-call.

Command · Description · Example
zerion analyze · Full analysis — portfolio, positions, transactions, PnL in parallel · zerion analyze vitalik.eth
zerion portfolio · Portfolio value and top positions · zerion portfolio 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
zerion positions · Token + DeFi positions (--positions all\ · simple\ · defi, or --defi for grouped-by-protocol view with loans netted) · zerion positions vitalik.eth --defi
zerion history · Transaction history (--limit, --chain) · zerion history vitalik.eth --limit 10 --chain ethereum
zerion pnl · Profit & loss (realized, unrealized, fees) · zerion pnl vitalik.eth
zerion search · Search tokens by name or symbol · zerion search USDC
zerion chains · List supported chains · zerion chains

Trading

Requires an API key (or agent token for unattended use).

Command Description Example
zerion swap Same-chain swap zerion swap base 1 USDC ETH
zerion swap solana Solana same-chain swap zerion swap solana 0.1 SOL USDC
zerion swap tokens [chain] List tokens available for swap zerion swap tokens solana
zerion bridge List all bridge providers (no execute, multi-offer case) zerion bridge base USDC 5 arbitrum USDC
zerion bridge … --cheapest Execute highest-output bridge route zerion bridge base USDC 5 arbitrum USDC --cheapest
zerion bridge … --fast Execute lowest-time bridge route zerion bridge base USDC 5 arbitrum USDC --fast
zerion bridge … --to-wallet Bridge with explicit destination wallet (Solana ↔ EVM) zerion bridge ethereum USDC 5 solana USDC --to-wallet sol-bot --cheapest
zerion bridge … --to-address Bridge to a raw destination address zerion bridge ethereum USDC 5 solana USDC --to-address 8xLdox… --cheapest
zerion send --to [--chain ] Send tokens (chain auto-detected from address format) zerion send usdc 50 --to 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 --chain base
zerion send SOL --to Send native SOL on Solana zerion send SOL 0.1 --to 2Nsnn…
zerion … --prepare Build + gate a command but print a prepared-group envelope (JSON) instead of executing — for zerion bundle zerion swap base 100 USDC ETH --prepare
zerion bundle --group [--group …] Sign several prepared groups together — one web-app handoff when any group needs review, else locally. Same signer address (chains may differ); per-group results; always exits 0 zerion bundle --group "$(zerion swap base 100 USDC ETH --prepare)" --group "$(zerion send USDC 20 --to 0xBob --chain base --prepare)"

Signing routes — local signing vs. web-app handoff

Every trade (and every message signature) takes one of two routes, decided automatically before
anything is signed:

  • Local signing (default) — the CLI signs with the agent token as passphrase and broadcasts. One shot, unattended.
  • Web-app handoff — the CLI encodes the transaction into an app.zerion.io link, opens a browser,
    and blocks until a human signs there (default 300s, --timeout to change). The URL is also printed to
    stderr, so headless/agent environments can hand it to the user. Nothing is signed locally; no agent token needed.

The handoff fires when any trigger hits:

Trigger Set by
Read-only wallet (no key material) zerion wallet add --name
Sell-side USD value over the wallet's review threshold — trades only zerion wallet set-review-threshold
Explicit force --review

Messages have no USD value, so sign-message / sign-typed-data ignore the threshold — only the
read-only and --review triggers apply there.

Both routes run the same pre-flight (balance gates, blocking-quote checks, agent policies), and every
trade prints Signing route: — to stderr plus signedVia: "local" | "web-app" in its
JSON output. If a threshold is set but the value can't be priced, the trade fails closed to review.
A handoff ends completed / rejected / failed / timeout (or aborted on Ctrl-C), reported as
status in that same JSON — only completed exits 0.

The threshold is a per-transaction ceiling. consolidate --execute is therefore always local: a sweep
is N independent transactions, and rows that are each under the threshold don't aggregate into a review
(it also needs key material, so it can't run on a read-only wallet). To have a whole sweep judged and
signed as one entity, run it through
zerion bundle --group "$(zerion consolidate --prepare)". Full reference:
capabilities/trading.md and
capabilities/bundle.md.

Wallet Management

Keystore wallets (encrypted on this machine), plus read-only wallets that sign via the web app. EVM + Solana supported. Passphrase required for all destructive ops.

Command · Description · Example
zerion wallet create --name · Create encrypted wallet (EVM + Solana) · zerion wallet create --name trading-bot
zerion wallet import --name --evm-key · Import from EVM private key (interactive) · zerion wallet import --name old-wallet --evm-key
zerion wallet import --name --sol-key · Import from Solana private key (interactive) · zerion wallet import --name sol-bot --sol-key
zerion wallet import --name --mnemonic · Import from seed phrase (all chains) · zerion wallet import --name backup --mnemonic
zerion wallet add --name · Add a read-only wallet — address only, no keys (0x, ENS, or Solana base58). Reads work normally; all signing hands off to the web app · zerion wallet add vitalik.eth --name vitalik
zerion wallet set-review-threshold · Route trades whose sell-side value exceeds ` to the web app for human review instead of auto-signing (offclears it) ·zerion wallet set-review-threshold trading-bot 500zerion wallet list· List all wallets (keystore + read-only) ·zerion wallet listzerion wallet fund· Show deposit addresses for funding ·zerion wallet fund --wallet trading-botzerion wallet backup --wallet · Export recovery phrase ·zerion wallet backup --wallet trading-botzerion wallet export-key --wallet [--chain evm\ · solana\ · all] [--index N]· Export raw private key(s) derived from mnemonic — EVM (0x hex) and/or Solana (base58 Phantom format + 32-byte ed25519 seed). Output is stderr-only. ·zerion wallet export-key --wallet trading-bot --chain evmzerion wallet delete · Permanently delete a wallet (requires passphrase) ·zerion wallet delete trading-botzerion wallet sync --wallet · Sync wallet to Zerion app via QR code ·zerion wallet sync --wallet trading-botzerion wallet sync --all· Sync all wallets to Zerion app ·zerion wallet sync --all`

Signing

Command · Description · Example
zerion sign-message --chain · Sign EIP-191 (EVM) or raw (Solana) message · zerion sign-message "Login to dApp" --chain ethereum
zerion sign-message --encoding hex · Treat message as hex bytes · zerion sign-message 0xdeadbeef --encoding hex --chain ethereum
zerion sign-typed-data --data '' · Sign EIP-712 typed data (EVM only) · zerion sign-typed-data --data "$(cat permit.json)"
zerion sign-typed-data --file · Read EIP-712 typed data from file · zerion sign-typed-data --file permit.json
cat typed.json \ · zerion sign-typed-data · Read EIP-712 typed data from stdin · cat permit.json \ · zerion sign-typed-data

Agent Tokens

Scoped API tokens for unattended trading. Token auto-saves to config; required for swap, bridge, send.

Command Description Example
zerion agent create-token --name --wallet Create scoped token (interactive passphrase) zerion agent create-token --name dca-bot --wallet trading-bot
zerion agent create-token … --passphrase-file Non-interactive: passphrase read from a chmod 600 file (CI / headless) zerion agent create-token --name dca-bot --wallet trading-bot --policy --passphrase-file /run/zerion/pass
zerion agent list-tokens List active agent tokens zerion agent list-tokens
zerion agent use-token --wallet Switch active token by wallet zerion agent use-token --wallet trading-bot
zerion agent revoke-token --name Revoke a token zerion agent revoke-token --name dca-bot

Agent Policies

Restrict what an agent token can do — chains, expiry, transfers, approvals, allowlists.

Command Description Example
zerion agent create-policy --name Create security policy (flags below) zerion agent create-policy --name safe-base --chains base --expires 24h --deny-transfers
zerion agent list-policies List all policies zerion agent list-policies
zerion agent show-policy Show policy details zerion agent show-policy safe-base
zerion agent delete-policy Delete a policy zerion agent delete-policy safe-base

Policy flags:

Flag Description
--chains Restrict to specific chains (comma-separated)
--expires Token expiry (e.g. 24h, 7d)
--deny-transfers Block raw ETH/native transfers
--deny-approvals Block ERC-20 approval calls
--allowlist Only allow listed contract/wallet addresses

Watchlist

Track wallets by name without exposing addresses in commands.

Command Description Example
zerion watch --name Add wallet to watchlist zerion watch 0xFe89Cc7Abb2C4183683Ab71653c4cCd1b9cC194e --name ens-dao
zerion watch list List watched wallets zerion watch list
zerion watch remove Remove from watchlist zerion watch remove ens-dao
zerion analyze Analyze a watched wallet by name zerion analyze ens-dao

Setup

Command Description Example
zerion login Authenticate — browser (dashboard) login, paste an API key, or pay-per-call zerion login
zerion login --browser Browser auth: opens dashboard.zerion.io, captures the key via loopback zerion login --browser
zerion init One-shot onboarding — install CLI globally, browser login, install agent skills npx zerion-cli@latest init
zerion init -y Same, without prompts: browser login, then install every skill zerion init -y
zerion init --no-open Print the authorize URL instead of opening a browser (remote / headless) zerion init --no-open
zerion setup skills Install Zerion agent skills into detected coding agents zerion setup skills
zerion setup skills --agent claude-code Install into a specific agent zerion setup skills --agent claude-code

Configuration

Command Description Example
zerion config set Set config (apiKey, defaultWallet, defaultChain, slippage) zerion config set defaultChain base
zerion config unset Remove a config value (resets to default) zerion config unset defaultChain
zerion config list Show current configuration zerion config list

Per-wallet review thresholds also live in ~/.zerion/config.json, but are set with their own command
rather than config set — see zerion wallet set-review-threshold.

Global Flags

Flag · Description
--wallet · Source wallet (default: from config)
--address · Use raw address or ENS name
--watch · Use watched wallet by name
--chain · Chain for analysis commands (default: ethereum)
--to-wallet · Destination wallet for bridge (Solana ↔ EVM)
--to-address · Destination address for bridge (must match destination-chain format)
--positions all\ · simple\ · defi · Filter positions type
--defi · On positions: shorthand for --positions defi with output grouped by protocol (LP tokens pooled by group_id, loans netted in net_value)
--limit · Limit results (default: 20 for list ops)
--offset · Skip first N results (pagination)
--search · Filter wallets by name or address
--slippage · Slippage tolerance (default: 2%)
--review · Force this trade to the web app for human review instead of auto-signing (see Signing routes)
--prepare · On send/swap/bridge/consolidate: print a prepared-group envelope instead of executing — the input to zerion bundle
--timeout · Wait budget: broadcast confirmation on the local route (default 120), or the browser-callback wait on a web-app handoff (default 300)
--x402 · Pay-per-call on Base or Solana (analytics only)
--mpp · Pay-per-call on Tempo (analytics only)
--json · JSON output (default)
--pretty · Human-readable output
--quiet · Minimal output

Environment Variables

Variable Description
ZERION_API_KEY API key (get at dashboard.zerion.io)
WALLET_PRIVATE_KEY Pay-per-call key. 0x... → x402 on Base; base58 → x402 on Solana; 0x... also works for MPP
EVM_PRIVATE_KEY EVM key for x402 on Base (overrides WALLET_PRIVATE_KEY for EVM)
SOLANA_PRIVATE_KEY Solana key for x402 on Solana (overrides WALLET_PRIVATE_KEY for Solana)
TEMPO_PRIVATE_KEY EVM key for MPP on Tempo (overrides WALLET_PRIVATE_KEY for MPP)
ZERION_X402 true enables x402 globally (analytics only)
ZERION_X402_PREFER_SOLANA true prefers Solana over Base when both keys set
ZERION_MPP true enables MPP globally (analytics only)
SOLANA_RPC_URL Custom Solana RPC endpoint
ETH_RPC_URL Custom Ethereum RPC endpoint (used for ENS resolution)

Output

All commands emit JSON to stdout (default) for agent compatibility. Errors emit JSON to stderr with a code field for programmatic handling. Use --pretty for human-readable output, --quiet for minimal.

Failure Modes

The CLI handles:

  • missing or invalid API key
  • invalid wallet address or ENS resolution failure
  • unsupported chain filter
  • empty wallets / no positions
  • rate limits (HTTP 429)
  • upstream timeout or temporary unavailability
  • a web-app handoff the human rejected, or that timed out waiting for the browser callback

All errors are emitted as structured JSON on stderr with a code field.

Development```bash

npm install
npm test # unit tests (fast, offline)
npm run test:integration # live API tests (requires ZERION_API_KEY, runs serially to avoid rate limits)
npm run test:all # both
node ./cli/zerion.js --help


Development requires **npm >=11.10** (see Supply-chain cooldown below); CI and `npm publish` run on Node 24.

### Supply-chain cooldown

To reduce exposure to npm supply-chain attacks, this repo enforces a **release-age cooldown**: `npm install` will only resolve dependency versions that have been published for at least a fixed number of days. Compromised "fresh" releases are usually detected and unpublished within that window.

The cooldown length is set by `min-release-age` in `.npmrc` — that line is the single source of truth for the window. It requires **npm >=11.10** (older npm silently ignores it); `devEngines` in `package.json` pins npm to that range with `onFail: error`, so an unsupported npm hard-fails instead of quietly skipping the cooldown.

The cooldown only affects version _resolution_ (i.e. updating `package-lock.json`); a plain install from the existing lockfile — including `npm ci` in CI — is unaffected.

**Overriding for an urgent fix.** If you need a security patch newer than the window, bypass it for a single install and commit the result:```bash
npm install <package>@<version> --min-release-age=0

Then commit the updated package-lock.json with a note explaining why.

Contribution guidelines

  • Keep examples copy-pasteable.
  • Prefer official Zerion naming and documented behavior.
  • Document real gaps instead of inventing interfaces.
  • Preserve JSON-first CLI output for agent compatibility.

Releasing to npm

This repo uses release-please for automated versioning and publishing.

Commit conventions — use Conventional Commits prefixes:

  • feat: — new feature → minor version bump
  • fix: — bug fix → patch version bump
  • feat!: or fix!: — breaking change → major version bump
  • docs:, chore:, test: — no release triggered

Release flow:

  1. Merge feat: or fix: commits to main
  2. release-please opens/updates a release PR (chore(main): release X.Y.Z) with version bump and CHANGELOG
  3. Merge the release PR when ready to ship
  4. GitHub Release is created automatically → triggers npm publish

To force a specific version, add Release-As: 2.0.0 in a commit message body.

CI setup:

  • NPM_TOKEN repo secret is required for npm publish (use a granular access token)
  • .release-please-manifest.json tracks the current version
  • .github/workflows/release-please.yml handles release PR creation and npm publish
  • .github/workflows/test.yml runs tests on PRs and pushes to main

Testing unreleased changes

Only release-please releases are published to npm; there is no prerelease channel. To try main or any branch before it ships, install it straight from GitHub:bash npm install -g github:zeriontech/zerion-ai#<branch>

npm install -g zerion-cli switches back to the latest release.

Resources

  • API documentation —
  • Get an API key —
  • Agent skills — ./skills/ (also installable via npx skills add zeriontech/zerion-ai)
  • Building with AI —

License

MIT — see LICENSE.

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Zerion Hosted MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Zerion Hosted MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Zerion Hosted MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Zerion Hosted MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Zerion Hosted MCP 能提供哪些能力?

资料显示能力标签包括 API密钥、金融数据、数据分析。具体工具清单以官方文档为准。

Zerion Hosted MCP 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

Zerion Hosted MCP 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。