Splits
NPM · @SPLITS/SPLITS-CLI
Give an AI agent its own key on a dedicated Splits account. At threshold 2+, a human co-signs.
Available components
Last scanned (12 hours ago)
Scores higher than 37% of npm servers
Category Finance and Payments
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. How we score → Why this is hard to score →
Supply Chain Security99
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 36 of 130 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency32
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: no license is declared. See how to fix → Fail
- Actively maintained (last published 5 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability63
- AI-judged instruction clarity (good).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 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. See how to fix → Fail
- An AI judge read all 91 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
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.
Checks we ran (15)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 16 Nov 26 64
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed npm/@splits/splits-cli@0.6.1
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 130 packages
| Packages resolved | 130 |
|---|---|
| Stale | 36 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
accounting_assertions_bulk ~155
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.
| Name | Type | Req | Description |
|---|---|---|---|
| file | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_assertions_designate ~143
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.
| Name | Type | Req | Description |
|---|---|---|---|
| chainId | integer | yes | Chain id |
| smartAccountId | string | yes | Account id the lot belongs to (from 'accounts list') |
| tokenAddress | string | yes | Token contract address (0x...) |
| transferId | string | yes | Inbound transfer to designate |
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounting_assertions_edit ~246
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Chain id |
| originLotId | string | – | Corrected lot this one carries basis from |
| smartAccountId | string | yes | Account id the lot belongs to (from 'accounts list') |
| sourceTransferId | string | yes | Transfer the lot opened from ('sourceTransferId' on the lot) |
| tokenAddress | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_assertions_revoke ~192
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).
| Name | Type | Req | Description |
|---|---|---|---|
| anchorOriginLotId | string | – | Origin lot on the edited lot, when it has one |
| chainId | integer | yes | Chain id |
| smartAccountId | string | yes | 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 | yes | 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. |
No output schema declared.
No examples provided.
accounting_assertions_seed ~256
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).
| Name | Type | Req | Description |
|---|---|---|---|
| acquisitionTime | string | yes | When the lot was acquired. ISO 8601, must be in the past. |
| chainId | integer | yes | Chain id |
| quantity | string | yes | Lot size in base units |
| smartAccountId | string | yes | Account id the lot belongs to (from 'accounts list') |
| targetKey | string | yes | 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 | yes | Token contract address (0x...) |
| unitPrice | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_categories_archive ~81
Archive a category. Rules and overrides that point at it keep resolving to it; re-point them to move those transfers.
| Name | Type | Req | Description |
|---|---|---|---|
| categoryId | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_categories_create ~113
Add a category. Labels are unique among the org's active categories. Only income and expense categories reach the P&L.
| Name | Type | Req | Description |
|---|---|---|---|
| accountType | string | yes | Account type |
| code | string | – | Your own account number, for matching to Xero or QBO |
| label | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_categories_list ~76
List the org's categories, with their account type and system key.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
accounting_categories_update ~133
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.
| Name | Type | Req | Description |
|---|---|---|---|
| accountType | string | – | New account type |
| categoryId | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_categorize_bulk ~139
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.
| Name | Type | Req | Description |
|---|---|---|---|
| file | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_categorize_revoke ~121
Remove the override on transfers or accrual lots, so rules and defaults categorize them again.
| Name | Type | Req | Description |
|---|---|---|---|
| targetIds | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_categorize_set ~153
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.
| Name | Type | Req | Description |
|---|---|---|---|
| categoryId | string | yes | Category id from 'accounting categories list' |
| targetIds | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_imports_create ~179
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Address to import (0x...) |
| chainIds | string | yes | 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 | yes | 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. |
No output schema declared.
No examples provided.
accounting_imports_list ~50
List imported accounts and their cutoff dates
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounting_imports_status ~98
Check the per-chain backfill for an import. Name the same chains the import was created with.
| Name | Type | Req | Description |
|---|---|---|---|
| chainIds | string | yes | Comma-separated chain ids the import was created with |
| smartAccountId | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_lots_assertions ~125
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | nextCursor from the previous page |
| limit | integer | – | Assertions per page, max 50 |
| lotId | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_lots_list ~366
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
accounting_recompute_current ~64
Read the recompute in flight or most recently settled for the org. A null job means lots are current.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounting_recompute_job ~94
Poll a recompute. Status 'unknown' still means settled. A non-null nextJobId means a write landed mid-run: poll that job next.
| Name | Type | Req | Description |
|---|---|---|---|
| jobId | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_recompute_run ~81
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.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounting_reports_generate ~717
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' }
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
No output schema declared.
No examples provided.
accounting_reports_job ~84
Check a queued report. Returns its download URL once the file is written. Report jobs do not retry, so failed is final.
| Name | Type | Req | Description |
|---|---|---|---|
| jobId | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_reports_list ~68
List the 50 most recent reports generated for your org, newest first. A ready report carries a downloadUrl you can fetch directly.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounting_rules_create ~175
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.
| Name | Type | Req | Description |
|---|---|---|---|
| categoryId | string | yes | Category id from 'accounting categories list' |
| chainId | integer | – | Match transfers on this chain |
| counterpartyAddress | string | – | Match transfers to or from this address |
| direction | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_rules_delete ~76
Delete a rule. Transfers it categorized fall back to the next most specific rule or the default.
| Name | Type | Req | Description |
|---|---|---|---|
| ruleId | string | yes | 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. |
No output schema declared.
No examples provided.
accounting_rules_list ~59
List the org's rules, with each counterparty's contact label when there is one.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounting_rules_update ~203
Change a rule's direction, category, or conditions. Omitted fields stay as they are; --clear removes conditions.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
No output schema declared.
No examples provided.
accounts_add-networks ~290
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.
| Name | Type | Req | Description |
|---|---|---|---|
| chainIds | string | yes | 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. |
No output schema declared.
No examples provided.
accounts_archive ~76
Archive a subaccount by address. Fails if the account has pending state changes. Requires owner-scoped API key.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Account address (0x...) |
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounts_balances ~111
Get token balances for an account. Earn vault rows include an earn object with the underlying asset and the amount the shares redeem for.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
accounts_chains ~86
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Account address (0x...) |
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounts_create ~263
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Account name (max 255 chars) |
| passkeyIds | string | – | Comma-separated passkey IDs from 'members signers' (e.g. id1,id2) |
| threshold | integer | yes | 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. |
No output schema declared.
No examples provided.
accounts_deploy ~120
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Account address (0x...) |
| chainId | integer | yes | Enabled network chain ID |
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounts_get ~58
Get account details by address
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Account address (0x...) |
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounts_list ~57
List accounts in your org
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
accounts_networks ~88
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.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounts_remove-networks ~209
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.
| Name | Type | Req | Description |
|---|---|---|---|
| chainIds | string | yes | 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. |
No output schema declared.
No examples provided.
accounts_rename ~90
Rename a subaccount by address. Name max 255 chars, trimmed. Requires owner-scoped API key.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Account address (0x...) |
| name | string | yes | 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. |
No output schema declared.
No examples provided.
accounts_sign-message ~334
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 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. |
No output schema declared.
No examples provided.
accounts_signers ~121
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Account address (0x...) |
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounts_unarchive ~81
Unarchive a previously archived subaccount by address. Fails if the account has required state updates pending. Requires owner-scoped API key.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Account address (0x...) |
| workspace | string | – | Workspace alias to run this command in (see `splits auth workspaces`). Overrides SPLITS_WORKSPACE and the active workspace. |
No output schema declared.
No examples provided.
accounts_update-signers ~695
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | yes | 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. |
No output schema declared.
No examples provided.
auth_create-key ~202
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
auth_delete-key ~88
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Address of the local key to remove. Required when several are saved. |
No output schema declared.
No examples provided.
auth_import-key ~129
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
auth_login ~442
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No output schema declared.
No examples provided.
auth_login-start ~325
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.
| Name | Type | Req | Description |
|---|---|---|---|
| clientName | string | yes | 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. |
No output schema declared.
No examples provided.
auth_login-status ~119
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.
| Name | Type | Req | Description |
|---|---|---|---|
| requestId | string | – | Login to check. Defaults to the most recent pending login. |
No output schema declared.
No examples provided.
auth_logout ~102
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.
| Name | Type | Req | Description |
|---|---|---|---|
| alias | string | – | Workspace alias to remove. Defaults to the active workspace. |
No output schema declared.
No examples provided.
auth_register-signer ~190
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 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. |
No output schema declared.
No examples provided.
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.
npm · @splits/splits-cli
claude mcp add 0xsplits-splits-cli -- npx -y @splits/splits-cli --mcp
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.