# Splits (npm · @splits/splits-cli)

Give an AI agent its own key on a dedicated Splits account. At threshold 2+, a human co-signs.

- Trust score: 64/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- npm · `@splits/splits-cli`: 64/100 (this document), [markdown](https://verifymcp.io/servers/0xsplits-splits-cli/splits-splits-cli.md), [page](https://verifymcp.io/servers/0xsplits-splits-cli/splits-splits-cli)

## Channel facts

- Registry: `npm`
- Package: `@splits/splits-cli`
- Version: `0.6.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 99/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 36 of 130 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 5 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 16639 tokens (~182/item across 91 items; 91 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 10 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "accounting_assertions_revoke" implies "revoke" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 91 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the Splits MCP server?

Splits runs locally as an npm package, launched with npx -y @splits/splits-cli --mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add 0xsplits-splits-cli -- npx -y @splits/splits-cli --mcp
```

### Cursor

```json
{
  "mcpServers": {
    "0xsplits-splits-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@splits/splits-cli",
        "--mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "0xsplits-splits-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@splits/splits-cli",
        "--mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add 0xsplits-splits-cli -- npx -y @splits/splits-cli --mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "0xsplits-splits-cli": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@splits/splits-cli",
        "--mcp"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  0xsplits-splits-cli:
    command: "npx"
    args: ["-y", "@splits/splits-cli", "--mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "0xsplits-splits-cli": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@splits/splits-cli",
        "--mcp"
      ]
    }
  }
}
```

### Other

```json
{
  "mcpServers": {
    "0xsplits-splits-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@splits/splits-cli",
        "--mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-16 (score 64)

First indexed and scored.

## MCP tools (91)

### `accounting_assertions_bulk` (~155 tokens)

Write up to 250 assertions from a JSON file, as one atomic insert: a rejected row leaves nothing behind. The file holds an array of assertion objects, each shaped like the body the single-assertion commands send ({ kind, smartAccountId, chainId, tokenAddress, ... }); field names match the single-assertion flags. Every seed must carry a targetKey, so re-running the same file corrects those lots instead of creating a second set of them.

Input parameters:

- `file` (string, required): Path to a JSON file holding an array of assertions
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_assertions_designate` (~143 tokens)

Mark an inbound transfer as drawing from seeded inventory, so it carries basis from the seed instead of opening a fresh lot at the transfer's price. A seed becomes a lot only once an inbound is designated against it.

Input parameters:

- `chainId` (integer, required): Chain id
- `smartAccountId` (string, required): Account id the lot belongs to (from 'accounts list')
- `tokenAddress` (string, required): Token contract address (0x...)
- `transferId` (string, required): Inbound transfer to designate
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_assertions_edit` (~246 tokens)

Correct a lot the engine derived, naming it by the transfer it opened from. Asserts at least one of unit price, acquisition time, or origin lot. Quantity is never editable: the account's real balance is ground truth.

Input parameters:

- `acquisitionTime` (string): Corrected acquisition time. ISO 8601, must be in the past.
- `anchorOriginLotId` (string): Origin lot currently on the lot being edited ('originLotId'). Part of the lot's identity, not a new value.
- `chainId` (integer, required): Chain id
- `originLotId` (string): Corrected lot this one carries basis from
- `smartAccountId` (string, required): Account id the lot belongs to (from 'accounts list')
- `sourceTransferId` (string, required): Transfer the lot opened from ('sourceTransferId' on the lot)
- `tokenAddress` (string, required): Token contract address (0x...)
- `unitPrice` (string): Corrected cost basis per whole token, in USD
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_assertions_revoke` (~192 tokens)

Withdraw an earlier assertion, returning the lot to what the engine derived. Names exactly one of --target-key (a seed), --source-transfer-id (an edit), or --transfer-id (a designation).

Input parameters:

- `anchorOriginLotId` (string): Origin lot on the edited lot, when it has one
- `chainId` (integer, required): Chain id
- `smartAccountId` (string, required): Account id the lot belongs to (from 'accounts list')
- `sourceTransferId` (string): Transfer an edited lot opened from
- `targetKey` (string): Target key of a seeded lot
- `tokenAddress` (string, required): Token contract address (0x...)
- `transferId` (string): Inbound transfer a designation marked
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_assertions_seed` (~256 tokens)

Seed opening inventory: a lot that predates Splits custody. Requires unit price, acquisition time, and quantity together. A seed alone creates no lot: the lot appears once 'assertions designate' marks an inbound transfer as drawing from it. Quantity is in base units (wei for ETH, 6-decimal units for USDC).

Input parameters:

- `acquisitionTime` (string, required): When the lot was acquired. ISO 8601, must be in the past.
- `chainId` (integer, required): Chain id
- `quantity` (string, required): Lot size in base units
- `smartAccountId` (string, required): Account id the lot belongs to (from 'accounts list')
- `targetKey` (string, required): Caller-chosen key naming the seeded lot. Reuse it to correct that lot; pick a new one for a new lot. Rerunning with the same key updates the lot instead of creating a second one.
- `tokenAddress` (string, required): Token contract address (0x...)
- `unitPrice` (string, required): Cost basis per whole token, in USD
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_categories_archive` (~81 tokens)

Archive a category. Rules and overrides that point at it keep resolving to it; re-point them to move those transfers.

Input parameters:

- `categoryId` (string, required): Category id from 'accounting categories list'
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_categories_create` (~113 tokens)

Add a category. Labels are unique among the org's active categories. Only income and expense categories reach the P&L.

Input parameters:

- `accountType` (string, required): Account type
- `code` (string): Your own account number, for matching to Xero or QBO
- `label` (string, required): Category name, e.g. 'Software & services'
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_categories_list` (~76 tokens)

List the org's categories, with their account type and system key.

Input parameters:

- `includeArchived` (boolean): Include archived categories, which existing rules and overrides may still point at
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_categories_update` (~133 tokens)

Rename a category, change its account type, or set or clear its code. Pass at least one. Renaming keeps every rule and override pointing at it.

Input parameters:

- `accountType` (string): New account type
- `categoryId` (string, required): Category id from 'accounting categories list'
- `clearCode` (boolean): Remove the category's account number
- `code` (string): New account number
- `label` (string): New name
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_categorize_bulk` (~139 tokens)

Write up to 500 overrides from a JSON file, as one atomic insert: a rejected row leaves nothing behind. The file holds an array of { kind: 'set' | 'revoke', targetKind: 'transfer' | 'accrual_lot', targetId, categoryId? }; a set names a categoryId and a revoke doesn't. The last row per target wins.

Input parameters:

- `file` (string, required): Path to a JSON file holding an array of overrides
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_categorize_revoke` (~121 tokens)

Remove the override on transfers or accrual lots, so rules and defaults categorize them again.

Input parameters:

- `targetIds` (string, required): Comma-separated transfer ids (the Transfer ID column in exports) or accrual lot ids, up to 500
- `targetKind` (string): transfer for an asset transfer id, accrual_lot for a rebasing accrual's lot id
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_categorize_set` (~153 tokens)

Put transfers or accrual lots in a category. Internal, bridge, swap, and Earn transfers are rejected. To categorize every transfer with an address, write a rule instead.

Input parameters:

- `categoryId` (string, required): Category id from 'accounting categories list'
- `targetIds` (string, required): Comma-separated transfer ids (the Transfer ID column in exports) or accrual lot ids, up to 500
- `targetKind` (string): transfer for an asset transfer id, accrual_lot for a rebasing accrual's lot id
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_imports_create` (~179 tokens)

Import an address the org held before Splits, so its history feeds lot accounting. Queues a per-chain backfill; poll it with 'accounting imports status'. Replaying the same import returns the existing account rather than creating a second one.

Input parameters:

- `address` (string, required): Address to import (0x...)
- `chainIds` (string, required): Comma-separated chain ids to import history from (e.g. '8453,1')
- `cutoffAt` (string): Ignore activity after this instant, e.g. the date the treasury migrated to Splits. ISO 8601. Omit to import everything.
- `name` (string, required): Name for the imported account
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_imports_list` (~50 tokens)

List imported accounts and their cutoff dates

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_imports_status` (~98 tokens)

Check the per-chain backfill for an import. Name the same chains the import was created with.

Input parameters:

- `chainIds` (string, required): Comma-separated chain ids the import was created with
- `smartAccountId` (string, required): Imported account id from 'accounting imports create'
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_lots_assertions` (~125 tokens)

List the assertions written against a lot, oldest first, with the value each one replaced. Pages with --cursor; a null nextCursor means the last page. An unknown lot reads as empty.

Input parameters:

- `cursor` (string): nextCursor from the previous page
- `limit` (integer): Assertions per page, max 50
- `lotId` (string, required): Lot id from 'accounting lots list'
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_lots_list` (~366 tokens)

List tax lots, one page at a time. Use this to find the lot id, target key, anchor transfer, or transfer id an assertion needs to name.

Input parameters:

- `accountIds` (string): Comma-separated account ids (from 'accounts list')
- `chainIds` (string): Comma-separated chain ids
- `maxCostBasis` (string): Inclusive upper bound on cost basis, in USD
- `maxRemaining` (string): Inclusive upper bound on remaining quantity, in whole tokens
- `maxUnitCost` (string): Inclusive upper bound on cost per whole token, in USD
- `minCostBasis` (string): Inclusive lower bound on cost basis, in USD
- `minRemaining` (string): Inclusive lower bound on remaining quantity, in whole tokens
- `minUnitCost` (string): Inclusive lower bound on cost per whole token, in USD
- `openAsOf` (string): Read open inventory as of this instant. ISO 8601. Defaults to now.
- `pageIndex` (number): Zero-based page index
- `pageSize` (number): Rows per page, max 50
- `search` (string): Substring search by sending address
- `sortBy` (string): Sort column
- `sortDirection` (string): Sort direction
- `startDate` (string): Only lots acquired at or after this instant. ISO 8601.
- `status` (string): Which lots to include. Defaults to open.
- `tokens` (string): Comma-separated chainId:address pairs (e.g. '8453:0x8335...')
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_recompute_current` (~64 tokens)

Read the recompute in flight or most recently settled for the org. A null job means lots are current.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_recompute_job` (~94 tokens)

Poll a recompute. Status 'unknown' still means settled. A non-null nextJobId means a write landed mid-run: poll that job next.

Input parameters:

- `jobId` (string, required): Job id from 'accounting recompute current' or 'run'
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_recompute_run` (~81 tokens)

Queue a full lot recompute. Writes already queue one, so this is only for forcing a rebuild. Returns the running job instead of queueing a second. Requires a write-scoped key.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_reports_generate` (~717 tokens)

Generate a report and return its download URL, or write it to disk with --out. Waits for reports large enough to be queued, up to --timeout. Reports: transactions (all activity), lots (open inventory as of a date), lot-timeline (per-lot open and close events), realized-gains (RGL), tokens (per-token balances with cost basis and unrealized gain), statement (transactions + tokens + gains, always PDF), pnl (income and expenses by category plus realized gains; needs categorization enabled for the org). Each report ignores filters it does not support; each filter names the reports that read it. Examples: { report: 'realized-gains', period: 'lastYear', fileFormat: 'pdf', out: './rgl.pdf' }; { report: 'lots', openAsOf: '2026-12-31' }

Input parameters:

- `accountIds` (string): Comma-separated account ids to limit the report to (ids come from 'accounts list', not addresses). Omit for active accounts only; imported, archived, and automation accounts are left out unless passe…
- `byAccount` (boolean): One row per account and token instead of one per token. tokens only.
- `chainIds` (string): Comma-separated chain ids (e.g. '8453,1'). Omit for all chains. All reports except realized-gains.
- `endDate` (string): EXCLUSIVE upper bound on the reporting period. ISO 8601.
- `fileFormat` (string): File format to generate. The statement is always a PDF regardless of this flag.
- `force` (boolean): Overwrite the --out file if it already exists
- `inbound` (boolean): Include only inbound activity. Setting both --inbound and --outbound is the same as neither. transactions only.
- `maxAmount` (string): Inclusive upper bound on absolute USD value. transactions only.
- `memo` (string): Substring search across memos. transactions only.
- `minAmount` (string): Inclusive lower bound on absolute USD value. transactions only.
- `openAsOf` (string): The instant to read open inventory at. ISO 8601. Defaults to now. lots only.
- `out` (string): Write the report to this path instead of returning a URL. A directory (or a path ending in '/') writes under the report's generated filename. Refuses to replace an existing file unless --force is set.
- `outbound` (boolean): Include only outbound activity. transactions only.
- `period` (string): Date range shorthand resolved in your local timezone. Mutually exclusive with --startDate / --endDate.
- `report` (string, required): Which report to generate
- `search` (string): Substring search across token symbols and names. tokens only.
- `startDate` (string): Inclusive lower bound on the reporting period. ISO 8601. All reports except lots.
- `timeout` (number): Seconds to wait for a queued report before giving up and returning its job id.
- `tokens` (string): Comma-separated chainId:address pairs (e.g. '8453:0x8335...'). transactions, lots, and lot-timeline only.
- `transactionHash` (string): On-chain transaction hash. transactions only.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_reports_job` (~84 tokens)

Check a queued report. Returns its download URL once the file is written. Report jobs do not retry, so failed is final.

Input parameters:

- `jobId` (string, required): Job id returned by 'accounting reports generate'
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_reports_list` (~68 tokens)

List the 50 most recent reports generated for your org, newest first. A ready report carries a downloadUrl you can fetch directly.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_rules_create` (~175 tokens)

Add a rule. Sets a direction, a target category, and at least one condition. A rule with the same direction and conditions as an existing one is rejected.

Input parameters:

- `categoryId` (string, required): Category id from 'accounting categories list'
- `chainId` (integer): Match transfers on this chain
- `counterpartyAddress` (string): Match transfers to or from this address
- `direction` (string, required): Which transfers the rule matches
- `sourceSmartAccountAddress` (string): Match transfers on this org account: the sender for outbound, the receiver for inbound
- `tokenAddress` (string): Match transfers of this token. Requires --chain-id.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_rules_delete` (~76 tokens)

Delete a rule. Transfers it categorized fall back to the next most specific rule or the default.

Input parameters:

- `ruleId` (string, required): Rule id from 'accounting rules list'
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_rules_list` (~59 tokens)

List the org's rules, with each counterparty's contact label when there is one.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounting_rules_update` (~203 tokens)

Change a rule's direction, category, or conditions. Omitted fields stay as they are; --clear removes conditions.

Input parameters:

- `categoryId` (string): New target category id
- `chainId` (integer): Match transfers on this chain
- `clear` (string): Comma-separated conditions to remove: counterpartyAddress, sourceSmartAccountAddress, chainId, tokenAddress
- `counterpartyAddress` (string): Match transfers to or from this address
- `direction` (string): New direction
- `ruleId` (string, required): Rule id from 'accounting rules list'
- `sourceSmartAccountAddress` (string): Match transfers on this org account: the sender for outbound, the receiver for inbound
- `tokenAddress` (string): Match transfers of this token. Requires --chain-id.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_add-networks` (~290 tokens)

Add networks to every account in the org. Networks already on the org are kept. When an account needs an onchain change on a new network (a deployment or a signer sync), this creates one proposal that covers every network: it returns networksAdded false and the proposal. The proposal sits on the Treasury account, or on the Root account when the Treasury itself needs an update; check 'accounts signers <address>' on that account before signing. Sign it on the web via the returned signUrl, or with 'transactions sign <id>' from a local key that is a signer on that account. On a multisig, run 'transactions update-gas-estimation <id>' before the last signature. When no onchain change is needed, the networks are added right away and networksAdded is true. Use 'accounts networks' for the networks already enabled and 'chains list' for the supported ones. Returns 400 SMART_ACCOUNT_MERKLE_TRANSACTION_IN_PROGRESS while another signer or network change is pending. Requires owner-scoped API key.

Input parameters:

- `chainIds` (string, required): Comma-separated chain ids to add (e.g. '10,42161')
- `memo` (string): Optional memo (max 500 chars)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_archive` (~76 tokens)

Archive a subaccount by address. Fails if the account has pending state changes. Requires owner-scoped API key.

Input parameters:

- `address` (string, required): Account address (0x...)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_balances` (~111 tokens)

Get token balances for an account. Earn vault rows include an earn object with the underlying asset and the amount the shares redeem for.

Input parameters:

- `address` (string): Account address (0x...). Auto-selected if org has one account.
- `chainIds` (string): Comma-separated chain IDs to filter (e.g. 1,8453)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_chains` (~86 tokens)

List every chain Splits supports, with whether this account's signers are in sync on each. For the networks enabled on the org, use 'accounts networks'.

Input parameters:

- `address` (string, required): Account address (0x...)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_create` (~263 tokens)

Create a new subaccount with specified signers and threshold. The subaccount is deployed with your org's treasury account as its onchain owner; signers transact, the owner recovers (see 'splits accounts'). Use 'members signers <userId>' to discover passkey IDs and 'auth signers' to discover EOA signer ids (register new ones with 'auth register-signer' first). Requires owner-scoped API key.

Input parameters:

- `eoaAddresses` (string): Comma-separated EOA signer addresses. Each must already be registered to your acting user via 'auth register-signer'. Convenience alternative to `--eoa-signer-ids`.
- `eoaSignerIds` (string): Preferred. Comma-separated EOA signer ids from 'auth signers' / 'auth register-signer'.
- `name` (string, required): Account name (max 255 chars)
- `passkeyIds` (string): Comma-separated passkey IDs from 'members signers' (e.g. id1,id2)
- `threshold` (integer, required): Number of signers required to approve transactions
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_deploy` (~120 tokens)

Create a deploy-only proposal for an existing account on an enabled network. The proposal makes a zero-value call to the account itself, so no funds move. Sign it via the returned signUrl or 'transactions sign <id>'; the account deploys only after the transaction executes.

Input parameters:

- `address` (string, required): Account address (0x...)
- `chainId` (integer, required): Enabled network chain ID
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_get` (~58 tokens)

Get account details by address

Input parameters:

- `address` (string, required): Account address (0x...)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_list` (~57 tokens)

List accounts in your org

Input parameters:

- `includeArchived` (boolean): Include archived accounts
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_networks` (~88 tokens)

List the networks enabled on the org, which every account operates on. Also returns the add-networks proposal still pending, if any, with the chains it adds and its signUrl. Those chains join the list once the proposal executes.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_remove-networks` (~209 tokens)

Remove networks from every account in the org. Takes effect right away and needs no signature; nothing happens onchain. When the org's accounts hold tokens on a removed network, it is refused unless --confirm-funds-on-removed-networks is passed. Those tokens stay at the same addresses but are inaccessible in Splits until the network is added again with 'accounts add-networks'. Use 'accounts networks' for the networks enabled now. Returns 400 SMART_ACCOUNT_MERKLE_TRANSACTION_IN_PROGRESS while a signer or network change is pending. Requires owner-scoped API key.

Input parameters:

- `chainIds` (string, required): Comma-separated chain ids to remove (e.g. '10,42161')
- `confirmFundsOnRemovedNetworks` (boolean): Remove networks even where the org's accounts hold tokens. Confirm with the user first.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_rename` (~90 tokens)

Rename a subaccount by address. Name max 255 chars, trimmed. Requires owner-scoped API key.

Input parameters:

- `address` (string, required): Account address (0x...)
- `name` (string, required): New account name (max 255 chars)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_sign-message` (~334 tokens)

Sign a message as the smart account (ERC-1271) with a local EOA saved by `splits auth create-key` or `splits auth import-key`. This can authorize compatible x402 or MPP payments as well as WalletConnect and Splits Connect requests; the payment method must accept ERC-1271 and package the signature. Pass exactly one of --message (plain text, personal_sign), --hex (raw bytes, personal_sign) or --typed-data (EIP-712 JSON), plus --chain-id. Creates the message, signs its signingHash, and returns the smart account signature once signatureCount reaches threshold. On a multisig the result has signature null; other signers add theirs with --id.

Input parameters:

- `address` (string, required): Account address (0x...) that signs the message
- `chainId` (integer): Chain id the signature is valid on. Required unless --id is set.
- `hex` (string): 0x-prefixed bytes to sign with personal_sign
- `id` (string): Sign an existing message instead of creating one
- `key` (string): Address of the local key to sign with. Required when several local keys are saved.
- `message` (string): Plain text to sign with personal_sign
- `name` (string): Label shown in the web app
- `typedData`: EIP-712 typed data as JSON (domain, types, primaryType, message)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_signers` (~121 tokens)

List passkey and EOA signers (with current threshold) for a subaccount. EOA ids here identify signers on this account and are used by `accounts update-signers --remove-eoa-ids`. To add an EOA, use its registration id from `auth signers` or `auth whoami` instead.

Input parameters:

- `address` (string, required): Account address (0x...)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_unarchive` (~81 tokens)

Unarchive a previously archived subaccount by address. Fails if the account has required state updates pending. Requires owner-scoped API key.

Input parameters:

- `address` (string, required): Account address (0x...)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `accounts_update-signers` (~695 tokens)

Propose adding or removing signers (passkeys and/or EOAs) and/or changing the threshold on a subaccount. EOA adds reference ids returned by `splits auth register-signer`; register the address first, then attach its id here. The same id can be attached to any number of accounts. Primary use case: adding an external (EOA) key so an agent or automation can operate on the account headlessly — passkeys require a biometric 2nd factor that agents cannot provide. A workspace owner can propose any change. An agent that joined as a member rather than an owner (`auth whoami` shows `user.kind: AGENT`, `members list` shows its role) can only propose adding its own EOA signers, with no passkey, removal or threshold change, and an owner signs it. The proposal is created immediately. Sign it on the web via the returned signUrl, or with 'transactions sign <id>' from a local key that is already a signer on the account. On a multisig, run 'transactions update-gas-estimation <id>' before the last signature. Size thresholds assuming any threshold-meeting signer set, agent keys included, can change signers. Poll 'transactions get <id>' to watch status transition from CREATED to EXECUTED. If this returns 400 SMART_ACCOUNT_MERKLE_TRANSACTION_IN_PROGRESS, call 'transactions list --account <address>' to find the pending proposal; it must be signed or cancelled before retrying. Recovery / resetting signers stays web-only — no CLI or API route exists. (Recovery is the owning account's contract-enforced right — see 'splits accounts'; the root account has no owner and cannot be recovered from above.) Updates apply to every active network on the org automatically. Use 'accounts signers <address>' to discover existing signer IDs (passkeys and EOAs), and `auth signers` to list the EOA ids registered under the acting user. Requires an owner-scoped API key, except for an agent that joined as a member adding its own EOA signers.

Input parameters:

- `account` (string, required): Subaccount address (0x...)
- `addEoaAddresses` (string): Comma-separated EOA signer addresses to attach. Each must already be registered to your acting user via `auth register-signer`. Convenience alternative to `--add-eoa-signer-ids` when you have the add…
- `addEoaSignerIds` (string): Preferred. Comma-separated EOA signer ids (from `auth register-signer` / `auth signers`) to attach. The same id can be attached to multiple accounts.
- `addPasskeyIds` (string): Comma-separated passkey authenticator IDs to add (from 'members signers')
- `memo` (string): Optional memo (max 500 chars)
- `removeEoaIds` (string): Comma-separated EOA signer IDs (from 'accounts signers <address>') to remove
- `removePasskeyIds` (string): Comma-separated passkey authenticator IDs to remove (from 'members signers')
- `threshold` (integer): New signer threshold. Unchanged if omitted.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `auth_create-key` (~202 tokens)

Generate a new local Ethereum EOA and add it to ~/.splits/config.json (mode 0600). The key is used by `splits transactions sign` to approve multisig transactions locally. Several keys can be saved; they are not tied to a workspace. By default creates the key only; pass --register to also register the address with the backend in one call (equivalent to `create-key` + `register-signer <address>`). On registration failure the new local key is removed so the next attempt starts fresh.

Input parameters:

- `name` (string): Optional human-readable label. Defaults to a short form of the address.
- `register` (boolean): Also register the new address with the backend so it can be attached as a signer. On backend failure the local key is rolled back.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `auth_delete-key` (~88 tokens)

Remove a local EOA signing key from ~/.splits/config.json. The address can be omitted when only one key is saved. Does NOT revoke the signer on-chain — if the key was registered via `update-signers`, run that command again (or the web app) to remove it.

Input parameters:

- `address` (string): Address of the local key to remove. Required when several are saved.

### `auth_import-key` (~129 tokens)

Import an existing Ethereum private key into the local config, next to any keys already saved. Importing an address that is already saved changes nothing. Prefer stdin to avoid leaking the key to shell history or tool-call transcripts:   `echo $PRIVATE_KEY | splits auth import-key`. The derived address is echoed to stderr before writing; the key itself is never returned.

Input parameters:

- `name` (string): Optional human-readable label. Defaults to a short form of the address.
- `privateKey` (string): Private key (0x-prefixed or raw hex). Refused under MCP mode; prefer stdin.

### `auth_login` (~442 tokens)

Save a Splits API key as a workspace in the local config (~/.splits/config.json, mode 0600) and make it the active workspace. Without --api-key or stdin, starts a browser login: it opens an approval page where the person connects an existing workspace or creates a new one, waits up to 10 minutes for the approval, and saves the key it receives. The key never appears in the output. With a key, the key is checked against the API first. The workspace is named after its org unless --name is given; logging in again to the same org refreshes that workspace. Other workspaces and local keys are never removed. The browser login prints a code that the person must type on the page, so an agent that cannot show the person this command's output while it waits (under MCP, or running it in a shell tool) uses `auth login-start` and `auth login-status` instead. Saved keys are only used when the SPLITS_API_KEY env var is not set — env always wins.

Input parameters:

- `apiKey` (string): API key value. Refused under MCP mode; prefer stdin for secrets.
- `clientName` (string): Required for a browser login, ignored when an API key is given. The name of the app the person is using to talk to you, as they would recognise it: for example `Claude Code`, `Claude Desktop`, `Codex…
- `key` (string): Saved local key that proves this agent in a browser login, and becomes the treasury signer if the person creates a workspace. Without it, the login uses a new key, which is saved under the workspace'…
- `name` (string): Workspace alias. Defaults to the org name in lowercase with dashes. An existing workspace with this alias is replaced.

### `auth_login-start` (~325 tokens)

Start a browser login without waiting for it, for MCP clients and agents that cannot block. Pass clientName with the product name of the app the person is using to talk to you (for example Claude Code), not the model name. Proves a new local key (or the one given with key), opens the approval page, and returns its URL and a code. Show the person the URL and the code, which they enter on the page, then call `auth login-status` right away without waiting for them to reply: it waits while they log in and approve (connect a workspace or create one). The request expires after 10 minutes.

Input parameters:

- `clientName` (string, required): The name of the app the person is using to talk to you, as they would recognise it: for example `Claude Code`, `Claude Desktop`, `Codex`, `Cursor` or `ChatGPT`. Use the product name, not the model na…
- `key` (string): Saved local key that proves this agent in a browser login, and becomes the treasury signer if the person creates a workspace. Without it, the login uses a new key, which is saved under the workspace'…
- `name` (string): Workspace alias. Defaults to the org name in lowercase with dashes. An existing workspace with this alias is replaced.

### `auth_login-status` (~119 tokens)

Wait for a browser login started by `auth login-start` or `workspace create` until the person approves or denies it, or it expires (10 minutes after it started). Once approved, saves the API key as a workspace, saves the signing key, makes it active, and returns the workspace (never the key). Denied and expired logins are returned as such and forgotten. If this call is cut off, call it again to keep waiting.

Input parameters:

- `requestId` (string): Login to check. Defaults to the most recent pending login.

### `auth_logout` (~102 tokens)

Remove a saved workspace (its API key and API URL override) from the local config. Without an alias, removes the active workspace. When the active workspace is removed and exactly one other remains, that one becomes active. Does not affect the SPLITS_API_KEY env var or any saved local EOA key — use `splits auth delete-key` to remove a local EOA.

Input parameters:

- `alias` (string): Workspace alias to remove. Defaults to the active workspace.

### `auth_register-signer` (~190 tokens)

Register an EOA address with the Splits backend so it can be attached to smart accounts as a signer. Idempotent — re-running with the same address returns the same id (and preserves the first name). The returned id is what `splits accounts update-signers --add-eoa-signer-ids` expects. The address is attributed to the user that owns the API key; you cannot register an address on behalf of another user. A registered EOA counts toward threshold identically to a passkey.

Input parameters:

- `address` (string, required): EOA address to register (0x...)
- `name` (string): Optional human-readable name for this signer. First name wins — re-registering with a different name keeps the original.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `auth_signers` (~87 tokens)

List EOA signers registered under the acting user. Returns the ids needed by `splits accounts update-signers --add-eoa-signer-ids` plus each signer's address, display name, and last verification timestamp.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `auth_use` (~58 tokens)

Make a saved workspace the active one. Commands run in the active workspace unless --workspace or SPLITS_WORKSPACE names another, or SPLITS_API_KEY is set.

Input parameters:

- `alias` (string, required): Workspace alias (see `splits auth workspaces`)

### `auth_whoami` (~235 tokens)

Show the current org, the API key name and scopes, and the user the key acts as. `user.kind` is AGENT when the key belongs to an agent. Also reports the workspace the credentials came from (null when SPLITS_API_KEY is set), whether they came from the environment or the local keystore, and the local EOA signing keys saved by browser login, `splits auth create-key`, or `import-key`. For each local key registered with the backend, `localKeys[].signerId` is the id needed by `accounts update-signers --add-eoa-signer-ids`. This registration id differs from the account-specific id in `accounts signers`, which is used for removals. A null id means the key is unregistered or the signer lookup failed; check `auth signers` before registering it again. Also updates the org id and name saved for the workspace, which `auth workspaces` shows.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `auth_workspaces` (~40 tokens)

List the workspaces saved by `splits auth login`, with the org each one belongs to and which one is active. API keys are never returned.

### `automations_create` (~370 tokens)

Create an automation: a new account that distributes every balance it receives without a signature. Pass-through sends a share of each balance as-is to one address on the same chain; each output swaps and/or bridges its share to a token on a chain and sends it to an address. The pass-through percent plus the output percents must equal 100. Use --forwarder for a plain forwarding address. Requires an owner-scoped key.

Input parameters:

- `forwarder` (string): Forward 100% of every balance, as-is, to this address. Cannot be combined with the pass-through or output options.
- `memo` (string): Optional memo
- `minimumThresholdUsd` (integer): Smallest balance, in USD, that triggers a run. Defaults to 5, like the web app.
- `name` (string, required): Automation name
- `outputs`: JSON array of outputs, each { percent, targetChainId, targetTokenAddress, destinationAddress }. Example: '[{"percent":100,"targetChainId":8453,"targetTokenAddress":"0x8335…","destinationAddress":"0x……
- `passThroughDestinationAddress` (string): Address that receives the pass-through share. Required without --forwarder, even when the pass-through percent is 0; the web app uses the same address as the outputs.
- `passThroughPercent` (integer): Percent of each balance sent as-is to the pass-through destination. Defaults to 100 minus the output percents.
- `slippage` (integer): Maximum slippage for swaps and bridges, in basis points. Defaults to 150, like the web app.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `automations_list` (~48 tokens)

List automations for your org

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `chains_get` (~66 tokens)

Get chain info by ID

Input parameters:

- `chainId` (number, required): Chain ID (e.g. 1, 8453)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `chains_list` (~45 tokens)

List all supported chains

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `contacts_list` (~67 tokens)

Search or list contacts for your org

Input parameters:

- `q` (string): Search term to filter contacts by name, label, or address
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `contacts_lookup` (~66 tokens)

Batch address lookup for contact info

Input parameters:

- `addresses` (string, required): Comma-separated Ethereum addresses to look up (max 100)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `feedback_send` (~166 tokens)

Send feedback to the Splits team about the API, this CLI, or the MCP server. Use it when a command fails in a way its help does not explain, a capability is missing, or a response is confusing. Include the goal, the command or request you ran, what came back, and what you expected. The Splits team gets it by email and can follow up with the user who owns the API key. Never include API keys, private keys, or other secrets.

Input parameters:

- `text` (string, required): The feedback: goal, command or request, response, and what was expected (max 5000 characters)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `invoices_create` (~402 tokens)

Create an invoice and email it to --payer-email right away. Without --payer-email, no email is sent. With --interval and --due-date-days, it also creates a schedule that emails a new invoice before each due date; when the first issue date is still in the future or the first due date has passed, only the schedule is created and the next daily run picks it up. Requires an owner-scoped key for an org owner and the Pro plan.

Input parameters:

- `accountAddress` (string): Account that receives the payment. Auto-selected if the org has one account.
- `allowFiatPayments` (boolean): Let the payer pay by bank transfer. Defaults to true.
- `amount` (string, required): Amount in token units (e.g. 1500.00)
- `ccEmails` (string): Comma-separated emails that get a copy (max 10). Requires --payer-email.
- `chainId` (integer, required): Chain the payer pays on
- `dueDate` (string, required): Due date, ISO 8601 (e.g. 2026-11-01T00:00:00Z). With a schedule, the first due date. Dates count as UTC calendar days.
- `dueDateDays` (integer): Days between each issue date and its due date. Requires --interval.
- `interval` (string): Repeat the invoice on each due date. ONCE sends a single invoice on its issue date. Requires --due-date-days.
- `memo` (string): Memo shown on the invoice
- `payeeName` (string, required): Name of who is billing
- `payerEmail` (string): Email the invoice is sent to
- `payerName` (string, required): Name of who pays
- `tokenAddress` (string, required): Token the payer pays in
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `invoices_get` (~55 tokens)

Get an invoice by id

Input parameters:

- `id` (string, required): Invoice ID
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `invoices_list` (~91 tokens)

List the org's invoices, newest first. Each invoice has a url where the payer views and pays it.

Input parameters:

- `statuses` (string): Comma-separated statuses to include: paid, unpaid, void. Omit to return every invoice except void ones.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `members_list` (~46 tokens)

List members of your org

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `members_signers` (~91 tokens)

List passkey signers for a specific org member by user ID. Use 'members list' first to find user IDs. Returns passkey IDs needed for 'accounts create'.

Input parameters:

- `userId` (string, required): Member user ID from 'members list'
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `offramp_external-accounts` (~93 tokens)

List the bank accounts the org can off-ramp to, with the currency each receives and the chain and token the off-ramp sends. Pass an id to `transactions create offramp`. Requires an owner-scoped API key for an org owner.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `org_create` (~54 tokens)

Start creating a new org. Sends a setup link to the provided email — complete org creation in the web UI.

Input parameters:

- `email` (string, required): Email address to receive the org setup link. Complete org creation in the web UI.

### `settings_get` (~71 tokens)

Get your org's settings: name, memo requirement, and auto-earn state (enabled and eligible chain ids, and any pending auto-earn transaction).

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `tokens_blocklist` (~69 tokens)

List your org's blocked tokens. Token allow/block lists affect display and balance filtering only; they are not enforced at proposal or signing time.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `tokens_metadata` (~76 tokens)

Get token metadata (symbol, decimals) by address and chain

Input parameters:

- `address` (string, required): Token contract address (0x...)
- `chainId` (number, required): Chain ID
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `tokens_whitelist` (~70 tokens)

List your org's allowlisted tokens. Token allow/block lists affect display and balance filtering only; they are not enforced at proposal or signing time.

Input parameters:

- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_cancel` (~70 tokens)

Cancel a pending transaction proposal. Only works on proposals in CREATED or DRAFTED status.

Input parameters:

- `id` (string, required): The proposal ID to cancel
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_create_auto-earn-off` (~153 tokens)

Create a proposal, for a human signer to approve, that turns auto-earn off for the whole workspace from the Treasury. It covers every network where auto-earn is on (autoEarn.enabledChainIds in `settings get`) and stops auto-earn on every account that has it. Requires an org owner or a Treasury signer, and fails while another auto-earn proposal is pending. Returns the proposal with the chainIds it covers and a signUrl.

Input parameters:

- `memo` (string): Optional memo for the transaction (max 500 chars)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_create_auto-earn-on` (~153 tokens)

Create a proposal, for a human signer to approve, that turns auto-earn on for the whole workspace from the Treasury. It covers every network that qualifies now (autoEarn.eligibleChainIds in `settings get`); a background job then enrolls the Treasury and its operating accounts. Requires an org owner or a Treasury signer, and fails while another auto-earn proposal is pending. Returns the proposal with the chainIds it covers and a signUrl.

Input parameters:

- `memo` (string): Optional memo for the transaction (max 500 chars)
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_create_custom` (~280 tokens)

Create a transaction proposal with raw EVM calls. Use for any on-chain action including contract interactions, approvals, and swaps.

Input parameters:

- `account` (string, required): The smart account address to create the proposal from (0x-prefixed, 40 hex chars)
- `calls` (array, required): Array of raw EVM calls; on the CLI, pass one JSON array. Each call has 'to' (address), 'data' (hex calldata), and optional 'value' (wei as string)
- `chainId` (number, required): The chain ID where the smart account is deployed (e.g., 1 for Ethereum, 8453 for Base)
- `memo` (string): Optional memo for the transaction (max 500 chars)
- `name` (string): Optional name for the proposal. If omitted, auto-generated from call details
- `properties`: Optional custom JSON metadata. Total minified ≤ 500 chars. Used as the base; any --property overlays are applied on top. To load from a file, use shell substitution: --properties "$(cat props.json)"
- `property` (array): String key/value overlays for properties; repeatable. Splits on the first '='.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_create_earn-deposit` (~308 tokens)

Create a proposal, for a human signer to approve, that deposits an asset from a smart account into its Earn vault. Specify amount in human-readable asset units (e.g. '100' for 100 USDC). Returns the proposal with the previewed vault shares and a signUrl.

Input parameters:

- `account` (string, required): The smart account address to create the proposal from (0x-prefixed, 40 hex chars)
- `amount` (string, required): The amount in human-readable asset units (e.g., '100' for 100 USDC)
- `asset` (string, required): The underlying asset of the vault (e.g. the USDC address)
- `chainId` (number, required): The chain ID where the smart account is deployed and the vault lives (e.g., 1 for Ethereum, 8453 for Base)
- `memo` (string): Optional memo for the transaction (max 500 chars)
- `properties`: Optional custom JSON metadata. Total minified ≤ 500 chars. Used as the base; any --property overlays are applied on top. To load from a file, use shell substitution: --properties "$(cat props.json)"
- `property` (array): String key/value overlays for properties; repeatable. Splits on the first '='. Example: --property invoice=INV-42
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_create_earn-withdraw` (~426 tokens)

Create a proposal, for a human signer to approve, that withdraws an asset from an Earn vault back to the smart account. Specify amount in human-readable asset units (e.g. '100' for 100 USDC), not vault shares. Returns the proposal with the previewed vault shares and a signUrl.

Input parameters:

- `account` (string, required): The smart account address to create the proposal from (0x-prefixed, 40 hex chars)
- `amount` (string, required): The amount in human-readable asset units (e.g., '100' for 100 USDC)
- `asset` (string, required): The underlying asset of the vault (e.g. the USDC address)
- `chainId` (number, required): The chain ID where the smart account is deployed and the vault lives (e.g., 1 for Ethereum, 8453 for Base)
- `memo` (string): Optional memo for the transaction (max 500 chars)
- `pauseAutoEarnSeconds` (integer): Pause auto-earn on this account and chain for 300, 3600, or 86400 seconds once the withdrawal executes, so the asset is not swept back into the vault. Defaults to 300 when auto-earn is on for the acc…
- `properties`: Optional custom JSON metadata. Total minified ≤ 500 chars. Used as the base; any --property overlays are applied on top. To load from a file, use shell substitution: --properties "$(cat props.json)"
- `property` (array): String key/value overlays for properties; repeatable. Splits on the first '='. Example: --property invoice=INV-42
- `vault` (string): The Earn vault to withdraw from. Defaults to the vault that accepts deposits for this asset on this chain. Pass it to withdraw from a legacy vault, which accepts withdrawals only
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_create_offramp` (~457 tokens)

Create a proposal that off-ramps USDC or EURC to one of the org's bank accounts through Bridge. Pick the bank with `offramp external-accounts`; it sets the chain, token, and recipient. Specify amount as the fiat the bank receives (minimum 10); the proposal sends that plus the off-ramp fee, and returns both the fee and the token amount sent. If the account holds the token in Earn or holds another token, pass --source-token to pay with it in the same proposal. Requires an owner-scoped API key for an org owner. Returns the proposal with the fee, the token amount sent, and a signUrl.

Input parameters:

- `account` (string, required): The smart account address to create the proposal from (0x-prefixed, 40 hex chars)
- `amount` (string, required): The fiat amount the bank receives, in its currency (e.g. '100' for $100 or €100). Minimum 10
- `externalAccountId` (string, required): The bank account id, from `offramp external-accounts`
- `memo` (string): Optional memo for the transaction (max 500 chars)
- `properties`: Optional custom JSON metadata. Total minified ≤ 500 chars. Used as the base; any --property overlays are applied on top. To load from a file, use shell substitution: --properties "$(cat props.json)"
- `property` (array): String key/value overlays for properties; repeatable. Splits on the first '='. Example: --property invoice=INV-42
- `sourceChainId` (number): Optional chain of --source-token. Defaults to the bank account's chain. A different chain bridges the payment and requires --source-token
- `sourceToken` (string): Optional token to pay with, like "Pay with" in the web app. Defaults to the bank account's token, a direct transfer. Any other token the account holds is swapped, or bridged when --source-chain-id di…
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_create_swap` (~565 tokens)

Create a proposal, for a human signer to approve, that sells an exact amount of one token for another, like the swap form in the web app. Pass destinationChainId to receive buyToken on another chain, which bridges the swap. The server fetches the quote and builds the calls. Specify amount in human-readable sellToken units (e.g. '100' for 100 USDC). Returns the proposal with the quoted buy amount and a signUrl.

Input parameters:

- `account` (string, required): The smart account address to create the proposal from (0x-prefixed, 40 hex chars)
- `amount` (string, required): The amount of sellToken to sell, in human-readable units (e.g., '100' for 100 USDC)
- `buyToken` (string, required): The token received on destinationChainId (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH). An Earn token deposits into that vault and is allowed only when the recipient is an account i…
- `chainId` (number, required): The chain ID where the account sells sellToken; the proposal runs on this chain (e.g., 1 for Ethereum, 8453 for Base)
- `destinationChainId` (number): The chain ID where buyToken is received. Defaults to chainId. A different chain bridges the swap, like the web app swap form with another destination chain
- `memo` (string): Optional memo for the transaction (max 500 chars)
- `properties`: Optional custom JSON metadata. Total minified ≤ 500 chars. Used as the base; any --property overlays are applied on top. To load from a file, use shell substitution: --properties "$(cat props.json)"
- `property` (array): String key/value overlays for properties; repeatable. Splits on the first '='. Example: --property invoice=INV-42
- `recipient` (string): Address that receives buyToken. Defaults to the account. Any other address adds a transfer to the proposal
- `sellToken` (string, required): The token the account sells on chainId (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH). An Earn token withdraws from that Earn position
- `slippageBps` (integer): Slippage tolerance in basis points (1 to 10000). Defaults to the web app's swap form default for the pair: 10 for two stablecoins, 50 for stablecoins and major assets, 150 otherwise
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_create_transfer` (~482 tokens)

Create a token transfer proposal from a smart account. Specify amount in human-readable units (e.g. '100' for 100 USDC). Returns the proposal with gas estimates.

Input parameters:

- `account` (string, required): The smart account address to create the proposal from (0x-prefixed, 40 hex chars)
- `amount` (string, required): The amount of --token the recipient receives, in human-readable units (e.g., '100' for 100 USDC, '0.5' for 0.5 ETH). With --source-token, the account spends whatever amount of it that costs
- `chainId` (number, required): The chain ID where the recipient receives the token (e.g., 1 for Ethereum, 8453 for Base)
- `memo` (string): Optional memo for the transaction (max 500 chars)
- `name` (string): Optional name for the proposal. If omitted, auto-generated from transfer details
- `properties`: Optional custom JSON metadata. Total minified ≤ 500 chars. Used as the base; any --property overlays are applied on top. To load from a file, use shell substitution: --properties "$(cat props.json)"
- `property` (array): String key/value overlays for properties; repeatable. Splits on the first '='. Example: --property invoice=INV-42
- `recipient` (string, required): The recipient address for the transfer (0x-prefixed, 40 hex chars, cannot be zero address)
- `sourceChainId` (number): Optional chain of --source-token. Defaults to --chain-id. A different chain bridges the payment to --chain-id
- `sourceToken` (string): Optional token to pay with, like "Pay with" in the web app. Defaults to --token, a direct transfer. Any other token the account holds is swapped, or bridged when --source-chain-id differs. An Earn to…
- `token` (string, required): The token the recipient receives. An Earn token address sends the Earn position itself and is allowed only to accounts in this workspace. To pay with a different token, such as from Earn, pass it as…
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_get` (~89 tokens)

Get details for a specific transaction. The item has the same shape as a 'transactions list' row, including dataType and its matching transactionData, merkleTransactionData or assetTransferData object.

Input parameters:

- `id` (string, required): Transaction ID
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_list` (~930 tokens)

List transactions for your org with optional filters. Examples: find ~$5k payment to Acme last month: { period: 'lastMonth', memo: 'Acme', minAmount: '4500', maxAmount: '5500', direction: 'outbound' }; all inbound activity this year on Base: { chainId: 8453, period: 'thisYear', direction: 'inbound' }; specific transaction by memo with explicit dates: { memo: 'Q1 payroll', startDate: '2026-01-01T00:00:00Z', endDate: '2026-04-01T00:00:00Z' }; look up a transaction by its user-op hash returned from 'transactions sign': { userOpHash: '0x1dfe…dcf' }; look up an on-chain transaction by hash: { transactionHash: '0xabc…def', chainId: 8453 }. Each row has a dataType and one object with its details. 'transaction' rows have transactionData: types, source, timestamps, failureReason, revertReason, usdNetValue, gasPaidBy, recipients and raw per-operation metadata. 'merkleTransaction' rows are proposals that run on several networks, such as a signer change. Their top-level chainId, transactionHash and userOpHash are null; read merkleTransactionData.chainTransactions for each network's status and hashes. 'assetTransfer' rows have assetTransferData: token address, symbol, decimals, the raw amount in base units, usdValue, from and to. Older API versions return rows without dataType or these objects.

Input parameters:

- `account` (string): Filter by smart account address. Single address or comma-separated list (e.g. '0xa…,0xb…'). Results union across all listed accounts.
- `chainId` (number): Filter by chain ID
- `cursor` (string): Pagination cursor from a previous response. You MUST replay the same filter values used on the request that produced this cursor.
- `direction` (string): Filter by money flow. 'inbound' returns only inbound asset transfers (excludes splits-initiated transactions, which are always outbound). 'outbound' returns splits transactions plus outbound asset tr…
- `endDate` (string): EXCLUSIVE upper bound on transactionTime. ISO 8601. '2026-04-01' does NOT include April 1. Use 2026-04-02 to include April 1.
- `limit` (number): Max results to return
- `maxAmount` (string): Inclusive upper bound on the absolute USD value. Same format as minAmount. Excludes transactions with no resolved USD price.
- `memo` (string): Case-insensitive substring search across transaction and asset-transfer memos. Min 3, max 500 chars. Most efficient combined with --account, --chainId, or a date range.
- `minAmount` (string): Inclusive lower bound on the absolute USD value. Positive decimal string (e.g. '1500.50'). Sign-agnostic — '1500' matches both +$1500 and -$1500. Excludes transactions with no resolved USD price.
- `period` (string): Date range shorthand resolved in your local timezone. Mutually exclusive with --startDate / --endDate. Valid values: thisWeek, thisMonth, thisYear, lastWeek, lastMonth, lastYear, last30Days, last90Da…
- `startDate` (string): Inclusive lower bound on transactionTime. ISO 8601 (YYYY-MM-DD interpreted as local-midnight, then converted to UTC).
- `transactionHash` (string): Filter by on-chain transaction hash (0x-prefixed, 32 bytes). Matches splits-initiated transactions and asset transfers in your org. Combine with --chainId to disambiguate the same hash across chains.
- `userOpHash` (string): Filter by ERC-4337 user-operation hash (0x-prefixed, 32 bytes). Returns 0 or 1 result. Only splits-initiated transactions have a userOpHash; asset-transfer rows are excluded when this filter is set.…
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_memo` (~80 tokens)

Set or clear the memo on a transaction

Input parameters:

- `id` (string, required): Transaction ID
- `memo` (string, required): New memo text (max 500 chars). Empty string clears the memo.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_properties_clear` (~59 tokens)

Clear all custom JSON metadata from a transaction.

Input parameters:

- `id` (string, required): Transaction ID
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_properties_replace` (~140 tokens)

Atomically replace all custom JSON metadata on a transaction (≤ 500 chars minified). Skips read-before-write.

Input parameters:

- `id` (string, required): Transaction ID
- `properties`: JSON object literal. Used as the base; any --property overlays are applied on top. To load from a file, use shell substitution: --properties "$(cat props.json)"
- `property` (array): String key/value overlays applied on top of --properties; repeatable. Splits on the first '='.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_properties_set` (~190 tokens)

Shallow-merge custom JSON metadata onto a transaction (≤ 500 chars minified).

Input parameters:

- `id` (string, required): Transaction ID
- `properties`: JSON object literal to shallow-merge into existing properties. Any --property overlays are applied on top. To load from a file, use shell substitution: --properties "$(cat props.json)"
- `property` (array): Set a single key/value pair as a string; repeatable. Splits on the first '='. Example: --property invoice=INV-42 --property region=us-east. Use 'replace' for non-string types or 'unset' to delete.
- `unset` (array): Delete a key from the existing properties; repeatable. Example: --unset oldkey
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_sign` (~264 tokens)

Sign a pending multisig transaction with a local EOA saved by `splits auth create-key` or `splits auth import-key`. Pass --key when several local keys are saved; with one it is used by default. Fetches the transaction's signingHash, produces a personal_sign signature locally, and submits it via POST /public/v1/transactions/:id/sign. By default auto-submits the UserOp when this signature meets threshold; pass --no-submit to record only. Retries once on a stale signer nonce. A signer or network change proposal ('accounts update-signers', 'accounts add-networks') submits on every network at once. On a multisig, run 'transactions update-gas-estimation <id>' before the last signature; otherwise the sign is rejected because the signingHash is stale.

Input parameters:

- `id` (string, required): Transaction ID to sign
- `key` (string): Address of the local key to sign with. Required when several local keys are saved.
- `noSubmit` (boolean): Record the signature but do not auto-submit the UserOp even if this signature meets threshold.
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `transactions_update-gas-estimation` (~114 tokens)

Update gas estimates for an existing transaction. For multisig, run this when one signer remains: it rotates the signingHash to the one the last signer must sign, including on a signer or network change proposal. The response's gasEstimates is null for those proposals, whose gas is estimated per network.

Input parameters:

- `id` (string, required): Transaction ID
- `workspace` (string): Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace.

### `workspace_create` (~520 tokens)

Create a new Splits workspace that the person owns and approves in the browser. Use this whenever a person is in the conversation. Opens the approval page on its create tab, prefilled with the name and chains; the person logs in, can change them, and approves. The person becomes the workspace's owner. Two accounts are created, at the same address on every chosen chain: the root, whose only signer is the person's login email and which owns the treasury, so the person can always recover it; and the treasury, whose only signer is this agent's local key, and which is the workspace's deposit address. The person can also connect an existing workspace instead. On approval the API key is saved as a new workspace and made active; the key never appears in the output. The person must enter a code on the page. Outside MCP the command prints the code, waits up to 10 minutes for the approval and prints a diagram of the accounts. Under MCP it returns the approval URL and the code without waiting: show both to the person, then call `auth login-status` right away, which waits for the approval, saves the workspace and returns the diagram. Use this rather than `org create` when this agent will work in the new workspace: `org create` only emails the person a setup link and gives this agent no API key and no signer. For a workspace this agent owns with no approval, see `workspace create-agent-owned`.

Input parameters:

- `chainIds` (string): Comma-separated chain ids to prefill (e.g. '8453,1'). Defaults to the chains a new workspace gets in the app.
- `clientName` (string, required): The name of the app the person is using to talk to you, as they would recognise it: for example `Claude Code`, `Claude Desktop`, `Codex`, `Cursor` or `ChatGPT`. Use the product name, not the model na…
- `key` (string): Saved local key that proves this agent in a browser login, and becomes the treasury signer if the person creates a workspace. Without it, the login uses a new key, which is saved under the workspace'…
- `name` (string, required): Workspace name to prefill. The local workspace alias is derived from the name the person approves.

### `workspace_create-agent-owned` (~470 tokens)

Create a new Splits workspace that this agent owns. No browser, no person approves: it is created at once, this agent is its only owner, and its API key has every scope. Use it only when the person explicitly asked for a workspace the agent owns, or when no person can approve. Never choose it because it is faster; when a person is in the conversation and did not ask for it, use `workspace create`. recoveryEmail is required and must be the email the person gave; never make one up. It is the only signer of the root account, which owns the treasury, and whoever logs in to Splits with it becomes an owner of the workspace. Splits sends it no email and does not verify it. This agent's local key is the only signer of the treasury, the deposit address on every chosen chain. A new local key is saved before the call. A key creates one workspace and gets its API key once: a second call with the same key is refused, and a new API key for that workspace needs a browser login (`auth login-start`) that an owner approves. The API key is saved as a new active workspace and never appears in the output. Off-ramp and paid plans stay unavailable until a person joins. The local key is the money: never print, paste or move it. Follow the `next` field of the result, and relay its warning to the person.

Input parameters:

- `chainIds` (string): Comma-separated chain ids (e.g. '8453,1'). Defaults to the chains a new workspace gets in the app.
- `clientName` (string, required): The name of the app the person is using to talk to you (for example `Claude Code`). It names the treasury signer and the API key.
- `key` (string): Saved local key that becomes the treasury signer. Without it, a new key is saved before the call. A key that already created a workspace is refused.
- `name` (string, required): Workspace name. The local workspace alias is derived from it.
- `recoveryEmail` (string, required): Email of the person who can recover the workspace, exactly as they gave it. Never make one up. It becomes the root signer, and whoever logs in to Splits with it becomes an owner.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/0xsplits-splits-cli/splits-splits-cli#diagnostics

## Score history

- 2026-11-21: 64
- 2026-11-20: 64
- 2026-11-19: 64
- 2026-11-18: 64
- 2026-11-17: 64
- 2026-11-16: 64

## Common questions

### What is the Splits MCP server?

Splits is an MCP server listed in the public MCP registry as io.github.0xSplits/splits-cli. Give an AI agent its own key on a dedicated Splits account. At threshold 2+, a human co-signs. This page covers its npm package (@splits/splits-cli).

### Is the Splits MCP server safe to use?

Splits scores 64 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Splits MCP server expose?

Splits exposes 91 tools: accounting_assertions_bulk, accounting_assertions_designate, accounting_assertions_edit, accounting_assertions_revoke, accounting_assertions_seed, and 86 more. Their descriptions and schemas cost roughly 16,639 tokens of context every time the server is loaded.

### Is the Splits MCP server still maintained?

Splits is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Splits MCP server?

VerifyMCP ran 15 checks on Splits, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Splits: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/@splits/splits-cli
- Socket report: https://socket.dev/npm/package/@splits/splits-cli
- Repository: https://github.com/0xSplits/splits-cli
- Website: https://splits.org/docs/introduction/agents
- Changelog RSS feed: https://verifymcp.io/servers/0xsplits-splits-cli/splits-splits-cli.xml
- Changelog JSON feed: https://verifymcp.io/servers/0xsplits-splits-cli/splits-splits-cli/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/0xsplits-splits-cli/splits-splits-cli.json
- HTML version of this page: https://verifymcp.io/servers/0xsplits-splits-cli/splits-splits-cli
