增加X

increasex 是一个围绕Increase的基于Go的包装器：

人性化的CLI
本地MCP服务器 stdio
两个接口共享一个应用程序核心
预览首次写入流程，以实现更安全的资金流动和对象创建

该项目是有意构建的，因此CLI命令和MCP工具使用相同的身份验证、验证、规范化、预览和执行路径。

隶属关系

IncreaseX是一个独立的、由社区维护的项目。它不是Increase Technologies，股份有限公司的附属公司、背书公司或赞助公司，也不是官方的Increase产品。

该项目旨在与Increase API和相关系统进行互操作。“Increase”是其各自所有者的商标。

当前状态

此存储库目前包括：

本地身份验证和配置文件处理
用于身份验证、帐户、余额、交易、转账、外部帐户、卡和 mcp serve
TTY菜单 increasex 和 increasex transfer
用于帐户、卡、外部帐户和转账驱动流的交互式选择器
预览带有确认令牌的首次写入流程
CLI和MCP中的转移审批队列操作
本地MCP服务器，为Codex和其他具有MCP功能的主机提供精心策划的分组工具界面

这不是什么：

不是官方Increase CLI的替代品
不是托管或远程MCP服务
不是浏览器UI

需求

转到1.26.1+
增加API键
如果您想要安全的本地凭据存储，可以访问macOS密钥链

快速开始

步骤1——安装二进制文件（推荐）：

GOCACHE=/tmp/increasex-gocache GOMODCACHE=/tmp/increasex-gomodcache go install github.com/gitsoecode/increasex-cli-mcp/cmd/increasex@latest

步骤2——验证您的PATH和二进制文件：

验证它是否在您的路径上：

which increasex
increasex --help

步骤3——使用持久的本地配置文件登录：

increasex auth login --name sandbox --env sandbox --api-key YOUR_INCREASE_API_KEY
increasex auth status

步骤4——验证CLI是否正常工作：

increasex accounts
increasex balance --account-id account_xxx
increasex

步骤5——安装Codex的配套技能（推荐）：

该回购还提供 increasex 帮助Codex使用的技能 mcp__increasex 安全并遵循预览优先写入流程。

npx skills add https://github.com/gitsoecode/increasex-cli-mcp --skill increasex

步骤6——在代理主机上注册MCP服务器：

因为二进制文件现在在你的 PATH，使用裸命令名（不是 $(pwd)/increasex).这样，无论您在哪个目录中，注册都会保持有效。

法典

codex mcp add increasex -- increasex mcp serve
codex mcp list

克劳德代码

claude mcp add increasex increasex mcp serve
claude mcp list

然后开始新的会话并问：

List the available MCP tool namespaces in this session.

你应该看看 mcp__increasex.

为什么这个命令很重要： MCP主机在注册时记录确切的二进制路径。如果您注册 $(pwd)/increasex 然后将二进制文件移动到 /usr/local/bin，记录的路径中断，MCP服务器无法连接。安装到 PATH 首先，使用裸命令名注册可以避免这种情况。

从源代码构建（可选/dev）

从repo根目录：

GOCACHE=/tmp/increasex-gocache go build -o increasex ./cmd/increasex

您只需要在代码更改时进行重建。

对于开发过程中的一次性运行：

./increasex --help

已安装 go install flow是其他设备的推荐设置。

安装

将二进制文件安装到您的 PATH 在注册MCP服务器之前。对于干净的环境，请使用源代码安装：

GOCACHE=/tmp/increasex-gocache GOMODCACHE=/tmp/increasex-gomodcache go install github.com/gitsoecode/increasex-cli-mcp/cmd/increasex@latest

如果需要，请确认：

which increasex
increasex --help

选项A--移至 /usr/local/bin （手动/从源路径安装）：

go build -o increasex ./cmd/increasex
sudo mv increasex /usr/local/bin/increasex

在大多数macOS系统上，写入 /usr/local/bin 需要 sudo.

选项B——将repo目录添加到shell中 PATH:

# in ~/.zshrc or ~/.bashrc
export PATH="$PATH:/path/to/this/repo"

然后重新加载外壳(source ~/.zshrc)并验证：

which increasex

如果您留在repo目录中并跳过PATH安装，请使用 ./increasex 对于CLI命令和 "$(pwd)/increasex" 注册MCP时，请注意，如果稍后移动或重命名目录，MCP注册将中断。

认证

这些示例使用repo本地调用(./increasex)默认情况下；如果您将二进制文件安装到 PATH，使用 increasex 相反。

increasex 支持两种身份验证模式：

建议：使用持久代理支持在本地存储凭据
仅限会话：打印外壳导出和 eval 他们

凭证解析顺序为：

显式标志
环境变量
持久本地凭据文件
钥匙扣镜

仅限会话登录

如果您不想存储凭据：

eval "$(./increasex auth login --name sandbox --env sandbox --api-key YOUR_INCREASE_API_KEY --print-env)"

这只为当前会话设置shell环境变量。

如果您已经存储了凭据，并有意将其加载到当前shell中：

eval "$(./increasex auth export --confirm)"

auth export 在您之前将原始API密钥打印到stdout eval 将其视为一个有意的、带有秘密的逃生通道，而不是默认的身份验证路径。

切换配置文件

切换持久化的默认配置文件，而不重新设置API键的中心：

./increasex auth use sandbox
./increasex auth use prod

在交互式身份验证菜单中，使用 Switch 选择存储的配置文件。MCP本身不切换配置文件；它使用服务器启动时处于活动状态的任何身份验证上下文，除非您启动 mcp serve 具有显式的身份验证覆盖。

检查身份验证

./increasex auth status
./increasex auth whoami

auth status 报告持久文件凭据是否可用、Keychain凭据是否可用，以及MCP是否已准备好而不需要shell导出。 auth whoami 验证当前凭证并显示活动配置文件、环境、令牌源和已解析的实体上下文，而不打印API密钥。

退出登录

./increasex auth logout

全球旗帜

所有顶级命令都支持：

--profile
--env
--json
--interactive
--yes
--debug
--api-key

MCP主机流

登录并向代理主机注册服务器，然后开始新的会话。

如果 increasex 在你的 PATH （推荐）：

法典

increasex auth login
increasex auth status
codex mcp add increasex -- increasex mcp serve
codex

克劳德代码

increasex auth login
increasex auth status
claude mcp add increasex increasex mcp serve
claude

如果您在没有安装PATH的情况下留在repo目录中，请替换 increasex 和 ./increasex 在CLI命令和 "$(pwd)/increasex" 在 mcp add 命令。

重要提示：

不要手动运行 ./increasex mcp serve --您的代理主机启动它
添加或更改MCP配置后启动新会话

该流在终端会话之间继续工作，因为 increasex 直接读取持久本地凭据文件。如果您使用以下命令更改活动配置文件 auth use，启动一个新的MCP主机会话，以便它获取新存储的默认配置文件。

示例：

./increasex --env sandbox accounts
./increasex --json accounts
./increasex --profile finance balance --account-id account_xxx

命令行用法

读取命令

列出帐户：

./increasex accounts
./increasex accounts --status open
./increasex accounts --limit 50

取得平衡：

./increasex balance --account-id account_xxx

列出交易记录：

./increasex transactions --account-id account_xxx
./increasex transactions --account-id account_xxx --period last-7d
./increasex transactions --account-id account_xxx --since 2026-03-01T00:00:00Z --until 2026-03-15T23:59:59Z
./increasex transactions --account-id account_xxx --category account_transfer_intention

当没有提供时间段时， transactions 默认为过去30天。

列表卡片：

./increasex cards
./increasex cards --account-id account_xxx

检索掩码卡详细信息：

./increasex cards retrieve --card-id card_xxx

检索卡详细信息：

./increasex cards details --card-id card_xxx

列出外部帐户：

./increasex external-accounts
./increasex external-accounts --status active

检索外部帐户：

./increasex external-accounts retrieve --external-account-id external_account_xxx

列表传输：

./increasex transfer list --rail account
./increasex transfer list --rail ach --status pending_approval

检索转账：

./increasex transfer retrieve --rail wire --transfer-id wire_transfer_xxx
./increasex transfer retrieve --transfer-id account_transfer_xxx
./increasex transfer retrieve --event-id event_xxx

列出审批队列：

./increasex transfer queue --rail ach

交互式CLI

当在TTY中运行时， increasex 可以使用交互式选择器，而不是预先要求每个ID。

示例：

./increasex
./increasex accounts
./increasex balance
./increasex transactions
./increasex transfer
./increasex transfer internal
./increasex transfer external
./increasex external-accounts
./increasex cards

当前的交互行为包括：

根和传输菜单，而不是没有子命令死胡同
可搜索帐户选择
可搜索卡片选择
可搜索的外部帐户选择
转移审批队列选择
列出帐户后的操作选择
嵌套交互式选择器中的显式后退和退出选项
键入 back 和 exit 支持自由文本提示
写入执行前的确认选择

如果要强制交互式提示：

./increasex --interactive accounts

如果你使用 --json，交互式UI被抑制。

人类可读的列表命令，如 accounts, transactions, cards, external-accounts，传输列表呈现为带有标记字段的记录块，而不是固定宽度的表，因此它们在窄终端和TUI包装器中保持清晰。

预览首次写入

所有写入命令和MCP工具都使用预览优先流：

默认CLI行为：预览、确认，然后执行
--dry-run 强制仅预览模式
预览返回摘要， confirmation_token，并执行审核元数据
MCP省略 dry_run 保持预览优先
主控程序 dry_run=true 预览
主控程序 dry_run=false 仅当您还提供有效的 confirmation_token
MCP执行调用还可能包括 approval_context 从预览中复制，以便主机权限提示清楚地显示已审阅的操作
如果不在CLI中手动传递令牌，CLI将首先进行预览，然后在执行前提示您

创建账户

仅预览：

./increasex accounts create --name "Operating" --dry-run

默认执行流程，带有交互式确认：

./increasex accounts create --name "Operating"

关闭帐户

仅预览：

./increasex accounts close --account-id account_xxx --dry-run

默认执行流程，带有交互式确认：

./increasex accounts close --account-id account_xxx

创建帐号

仅预览：

./increasex accounts create-number --account-id account_xxx --name "Vendor Receipts" --dry-run

默认执行流程，带有交互式确认：

./increasex accounts create-number --account-id account_xxx --name "Vendor Receipts"

内部转账

仅预览：

./increasex transfer internal \
  --from-account-id account_from \
  --to-account-id account_to \
  --amount-cents 5000 \
  --description "Ops funding" \
  --dry-run

默认执行流程，带有交互式确认：

./increasex transfer internal \
  --from-account-id account_from \
  --to-account-id account_to \
  --amount-cents 5000 \
  --description "Ops funding"

ACH转账

仅预览：

./increasex transfer external \
  --rail ach \
  --account-id account_xxx \
  --amount-cents 5000 \
  --statement-descriptor "VENDOR PAY" \
  --account-number 123456789 \
  --routing-number 021000021 \
  --dry-run

默认执行流程，带有交互式确认：

./increasex transfer external \
  --rail ach \
  --account-id account_xxx \
  --amount-cents 5000 \
  --statement-descriptor "VENDOR PAY" \
  --account-number 123456789 \
  --routing-number 021000021

RTP传输

仅预览：

./increasex transfer external \
  --rail real_time_payments \
  --rtp-creditor-name "Vendor LLC" \
  --rtp-remittance-information "Invoice 1001" \
  --rtp-source-account-number-id account_number_xxx \
  --rtp-destination-account-number 123456789 \
  --rtp-destination-routing-number 021000021 \
  --rtp-amount-cents 5000 \
  --dry-run

FedNow转账

仅预览：

./increasex transfer external \
  --rail fednow \
  --fednow-account-id account_xxx \
  --fednow-amount-cents 5000 \
  --fednow-creditor-name "Vendor LLC" \
  --fednow-debtor-name "My Company" \
  --fednow-source-account-number-id account_number_xxx \
  --fednow-account-number 123456789 \
  --fednow-routing-number 021000021 \
  --fednow-remittance "Invoice 1001" \
  --dry-run

电汇

仅预览：

./increasex transfer external \
  --rail wire \
  --wire-account-id account_xxx \
  --wire-amount-cents 5000 \
  --wire-beneficiary-name "Vendor LLC" \
  --wire-message-to-recipient "Invoice 1001" \
  --wire-account-number 123456789 \
  --wire-routing-number 021000021 \
  --dry-run

创建卡片

仅预览：

./increasex cards create --account-id account_xxx --description "Ops card" --dry-run

账单地址：

./increasex cards create \
  --account-id account_xxx \
  --description "Ops card" \
  --billing-line1 "123 Main St" \
  --billing-city "San Francisco" \
  --billing-state "CA" \
  --billing-postal-code "94105"

默认执行流程，带有交互式确认：

./increasex cards create --account-id account_xxx --description "Ops card"

创建外部帐户

仅预览：

./increasex external-accounts create \
  --description "Primary vendor destination" \
  --routing-number 021000021 \
  --account-number 123456789 \
  --dry-run

默认执行流程，带有交互式确认：

./increasex external-accounts create \
  --description "Primary vendor destination" \
  --routing-number 021000021 \
  --account-number 123456789

批准转账

仅预览：

./increasex transfer approve --rail ach --transfer-id ach_transfer_xxx --dry-run

默认执行流程，带有交互式确认：

./increasex transfer approve --rail ach --transfer-id ach_transfer_xxx

JSON输出

使用 --json 为了获得稳定的机器可读响应：

./increasex --json accounts
./increasex --json balance --account-id account_xxx

非JSON CLI输出针对人类进行了优化，并可能随着时间的推移而更改格式。使用 --json 用于自动化、解析和任何机器可读的工作流程。

响应形状：

{
  "ok": true,
  "request_id": "optional",
  "data": {}
}

错误使用：

{
  "ok": false,
  "request_id": "optional",
  "error": {
    "code": "validation_error",
    "message": "human readable message"
  }
}

MCP使用

increasex 通过以下方式公开本地MCP服务器 stdio.

此服务器是：

仅限本地
stdio 仅限运输
拟由具有MCP能力的主机（如Codex）启动

主机设置

将二进制文件安装到您的 PATH 第一（参见安装)，然后使用裸命令名注册：

法典

codex mcp add increasex -- increasex mcp serve
codex mcp list

克劳德代码

claude mcp add increasex increasex mcp serve
claude mcp list

如果注册时没有安装PATH，请使用完整路径： "$(pwd)/increasex" --但是如果稍后移动二进制文件或目录，注册将中断。

然后启动一个新的会话，并要求它列出可用的MCP命名空间或工具。

手动调试

您可以手动运行服务器：

./increasex mcp serve

如果你这样做，预计会有一个闪烁的光标。该进程正在等待标准输入上的MCP消息。这对于调试很有用，但这不是您通常使用Codex服务器的方式。

代理未收到您的API密钥。 increasex 从标志、环境或存储的配置文件本地解析auth，然后自己发出Increase API请求。

MCP工具表面

发现工具：

describe_capabilities

阅读工具：

list_accounts
resolve_account
list_account_numbers
retrieve_account_number
list_programs
retrieve_program
get_balance
list_recent_transactions 可选 since 和 until RFC3339边界
list_events
retrieve_event
list_documents
retrieve_document
list_cards
list_digital_card_profiles
retrieve_digital_card_profile
retrieve_card_details
retrieve_card_sensitive_details
create_card_details_iframe
list_external_accounts
retrieve_external_account
list_transfers
retrieve_transfer 使用 event_id, transfer_id 带有可推断的前缀，或 rail 加 transfer_id
list_transfer_queue 有首选轨道 account 用于内部转账； internal 和 account_transfer 是可接受的别名

写入工具：

create_account
close_account
create_account_number
disable_account_number

MCP事务过滤器输入示例：

{
  "account_id": "account_xxx",
  "since": "2026-03-01T00:00:00Z",
  "until": "2026-03-15T23:59:59Z"
}

create_account_transfer
create_ach_transfer
create_real_time_payments_transfer
create_fednow_transfer
create_wire_transfer
approve_transfer
cancel_transfer
create_external_account
update_external_account
create_card
update_card_pin

旧版本的兼容性别名仍然存在 move_money_* 传输工具名称。

该存储库还包括一个统一的 increasex 技能用于操作 mcp__increasex 安全，并在此仓库中实现新的IncreaseX功能。

安装技能

常规安装

npx skills add https://github.com/gitsoecode/increasex-cli-mcp --skill increasex

安装新技能后重新启动Codex，以便在新的会话中学习。

仅限克劳德代码

mkdir -p .claude/skills/increasex
curl -L https://raw.githubusercontent.com/gitsoecode/increasex-cli-mcp/main/skills/increasex/SKILL.md -o .claude/skills/increasex/SKILL.md

MCP写入模式

所有MCP写入都是先预览的：

无需调用工具 dry_run，或与 dry_run=true
接收预览详细信息，a confirmation_token，并执行审核元数据
再次调用同一工具 dry_run=false，有效载荷相同，可选 approval_context 从预览中复制

内部传输队列流示例：

{
  "name": "create_account_transfer",
  "arguments": {
    "from_account_id": "account_source",
    "to_account_id": "account_destination",
    "amount_cents": 500,
    "description": "fund MCP account",
    "require_approval": true
  }
}

然后使用返回的令牌执行排队写入：

{
  "name": "create_account_transfer",
  "arguments": {
    "from_account_id": "account_source",
    "to_account_id": "account_destination",
    "amount_cents": 500,
    "description": "fund MCP account",
    "require_approval": true,
    "approval_context": {
      "execute_action": "move_money_internal",
      "execute_summary": "Queue account transfer $5.00 for approval",
      "execute_details": {
        "from_account_id": "account_source",
        "to_account_id": "account_destination",
        "amount_cents": 500,
        "description": "fund MCP account",
        "require_approval": true
      },
      "execute_requires_confirmation": true
    },
    "confirmation_token": "TOKEN_FROM_PREVIEW",
    "dry_run": false
  }
}

如果你发送 confirmation_token 无需明确设置 dry_run=false，MCP返回a validation_error 而不是创建另一个预览。

该确认令牌是v1中唯一有意的交叉调用服务器状态。

故障排除

如果 ./increasex mcp serve 似乎挂起了，这是意料之中的。它正在等待MCP消息打开 stdin.

如果Codex没有显示 mcp__increasex:

重新生成二进制文件：

go build -o increasex ./cmd/increasex

确认MCP条目存在：

codex mcp list

开始新的食品法典会议。

已打开的Codex会话不会热重新加载新固定的MCP服务器。

如果你看到：

{
  "ok": false,
  "error": {
    "message": "auth_error: no credentials found for the selected profile"
  }
}

然后先登录：

./increasex auth login --name sandbox --env sandbox --api-key YOUR_INCREASE_API_KEY
./increasex auth status

然后重试：

./increasex accounts

如果MCP服务器在将二进制文件移动到后无法连接 /usr/local/bin （或其他地方）：

MCP注册记录了旧路径。使用裸命令名重新注册：

claude mcp remove increasex
claude mcp add increasex increasex mcp serve

或者对于Codex：

codex mcp remove increasex
codex mcp add increasex -- increasex mcp serve

重新注册后开始新的会话。

如果 increasex 也为“找不到命令”：

跑 ./increasex 从回购根目录，或
将二进制文件移动到您的 PATH （参见安装)

如果之前在另一台设备上运行时失败 go build -o increasex ./cmd/increasex，确认您正在使用来自的安装流程安装部分。没有可构建的陈旧环境 cmd/increasex 导致此症状的包装；这个存储库现在包括一个真正的 cmd/increasex 入口点。

发展

运行测试：

GOCACHE=/tmp/increasex-gocache go test ./...

运行棉绒检查：

GOCACHE=/tmp/increasex-gocache go vet ./...

构建：

GOCACHE=/tmp/increasex-gocache go build -o increasex ./cmd/increasex

另请参见：

Increasex CLI MCP

快速接入

详细介绍

增加X

隶属关系

当前状态

需求

快速开始

从源代码构建（可选/dev）

安装

认证

推荐登录

仅限会话登录

切换配置文件

检查身份验证

退出登录

全球旗帜

MCP主机流

命令行用法

读取命令

交互式CLI

预览首次写入

创建账户

关闭帐户

创建帐号

内部转账

ACH转账

RTP传输

FedNow转账

电汇

创建卡片

创建外部帐户

批准转账

JSON输出

MCP使用

主机设置

手动调试

MCP工具表面

安装技能

常规安装

仅限克劳德代码

MCP写入模式

故障排除

发展

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP