agent-mcp-cli 用于从 shell 直接调用 agent-mcp 的只读工具，无需在客户端注册 MCP 服务器。它使用项目的 artisan 命令，示例为 php artisan，项目命令形式不同时（如 vendor/bin/sail artisan）以项目实际为准。
使用场景：一次性调用、脚本、CI 任务，或 agent-mcp 服务器未注册到客户端时，适合选用 CLI；需要跨多轮持续、低延迟访问工具时，再注册 MCP 服务器（HTTP 路由或 stdio 桥接）。
工作流：先用 php artisan agent-mcp:tools 列出可调用工具（加 --all 可包含配置中 enabled: false 的工具）；用 php artisan agent-mcp:schema <tool> 查看输入 schema；调用时以位置参数或在 STDIN 传入 JSON 参数对象，例如 php artisan agent-mcp:call db_schema '{"table":"users"}'，或 echo '{"table":"users"}' | php artisan agent-mcp:call db_schema。结果 JSON 输出到 stdout（终端下美化，管道时原始，可用 --raw 强制原始），诊断信息到 stderr，工具出错时退出码非零；可管道处理：php artisan agent-mcp:call db_schema --raw | jq .。
本地与远程：默认本地，在当前应用进程内运行工具；远程则转发到远程 /agent-mcp 端点，并使用 AGENT_MCP_KEY 作为 Bearer token。配置远程 URL 后自动选择远程，--local 与 --remote 可强制选择。密钥只走 Authorization 头，不会出现在输出中。
配置远程 URL：可用 php artisan agent-mcp:install --url=https://your-app.example.com/agent-mcp 将 url 键写入 .agent-mcp.json 并提交（推荐团队使用），也可用环境变量 AGENT_MCP_URL 覆盖（env 优先于文件）。安全限制：URL 必须为 https，仅环回地址（localhost、127.0.0.1、::1）可使用 http；AGENT_MCP_KEY 仅存于环境变量，不写入 .agent-mcp.json 或任何提交文件，由 .env 自动加载，无需手动导出或命令行传入；提交 URL 属于凭据路由决策，需先审查；已提交 URL 但环境中无 AGENT_MCP_KEY 时会显式报错，不会静默回退本地。
安全说明：这些工具是只读的，应表达想做的变更而非尝试写入。敏感工具（config_inspect、db_slow_queries、db_active_locks、cache_keys、run_artisan）默认关闭，启用后其输出可能进入终端回滚和 shell 历史，因此 agent-mcp:call 除非传入 --allow-tty，否则拒绝把敏感工具结果打印到终端；管道或重定向始终允许。不要将 agent-mcp:* 命令加入 run_artisan 允许列表。脱敏是尽力而为而非保证，真正的边界是只读数据库授权和单工具启用开关。
更多命令与参数见 references/commands.md，各工具用途与返回见 agent-mcp-investigation 技能。社区互动（star 与 issue）为可选、仅凭文字许可、绝不自动执行，每会话最多各一次，短会话、任务中、失败后或调试中应跳过。其他细节资料未提供。