![\"amcp,](\"https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/packages/cli/assets/hero.png\")
\n \n\n \n \n \n
amcp)\n Call MCP tools, run code-mode programs and manage your whole MCP gateway from the terminal.
\n The official command-line client for AnythingMCP, the open-source agent harness and MCP gateway.\n
\n ![\"npm](\"https://img.shields.io/npm/v/@anythingmcp/cli?color=2159e0&label=npm\")
![\"npm](\"https://img.shields.io/npm/dm/@anythingmcp/cli?color=2159e0\")
![\"Node.js](\"https://img.shields.io/node/v/@anythingmcp/cli?color=2159e0\")
![\"License:](\"https://img.shields.io/badge/license-AGPL--3.0-2159e0\"){kind=icon}
\n Website ·\n Guide with examples ·\n API reference ·\n AnythingMCP on GitHub\n
\n\n---\n\n`amcp` does two jobs with one binary:\n\n- **Calls MCP tools.** These are the same tools your AI clients use (Shopify, HubSpot, SAP, Odoo, Postgres, an SFTP share…). You can run them by hand, in shell scripts, from cron and CI, or as a **code-mode program** that loops over dozens of tool calls in a single step.\n- **Drives the management API.** With a management-scoped key, everything the dashboard does — connectors, MCP servers, users, roles, SSO, memory, skills, audit — is one `amcp api` command away, for a person or for a connected AI agent.\n\nIt works with [AnythingMCP Cloud](https://cloud.anythingmcp.com) and self-hosted instances.\n\n```bash\nnpm i -g @anythingmcp/cli\n```\n\nOr with Homebrew on macOS and Linux, which also installs Node.js and the shell completions:\n\n```bash\nbrew install helpcode-ai/tap/amcp\n```\n\nWith npm, it requires Node.js 22.12 or newer. The examples below use real commands, flags, endpoints and tool names (the Shopify, HubSpot and Slack tools come from the built-in catalogue connectors). Only the data in the output is invented.\n\n## Contents\n\n- [Quick start](#quick-start)\n- [Recipes](#recipes)\n - [Call a tool with real arguments](#call-a-tool-with-real-arguments)\n - [Pipe results into jq, cron and CI](#pipe-results-into-jq-cron-and-ci)\n - [Code mode: one program, many tool calls](#code-mode-one-program-many-tool-calls)\n - [Stand up a workspace in one script](#stand-up-a-workspace-in-one-script)\n - [Turn your own API into MCP tools](#turn-your-own-api-into-mcp-tools)\n - [See what your agents did](#see-what-your-agents-did)\n - [Check what a plan change would pause (Cloud)](#check-what-a-plan-change-would-pause-cloud)\n- [Command reference](#command-reference)\n- [Management API (`amcp api`)](#management-api-amcp-api)\n- [Shell completion](#shell-completion)\n- [Security](#security)\n- [About AnythingMCP](#about-anythingmcp)\n\n## Quick start\n\n`amcp` uses two kinds of key, each in its own profile:\n\n| You want to… | Key | Log in with |\n|---|---|---|\n| Call the tools of one MCP server | an **MCP key** for that server | `amcp login --url … --server SERVER_ID` |\n| Manage the instance (`amcp api`) | a **management key** (read-only or admin) | `amcp login --browser` |\n\n```console\n$ amcp login --url https://cloud.anythingmcp.com --server cmob60dvv00c01zrpeujwmnep\nMCP API key:\nLogged in to https://cloud.anythingmcp.com (profile: default).\n\n$ amcp tools ls --filter order\nshopify_search_orders read-only Search orders with Shopify search syntax (for example `financial_status:paid …\nshopify_get_order read-only Get one order: status, totals (subtotal, shipping, tax, discounts, refunds) …\n\n$ amcp login --browser --scope admin --url https://cloud.anythingmcp.com\nLogged in to https://cloud.anythingmcp.com (management, profile: default).\n\n$ amcp api GET /api/mcp-servers | jq -r '.[] | \"\\(.id) \\(.name)\"'\ncmob60dvv00c01zrpeujwmnep Default\ncmoc2k4hd00f11zrp9xq3vbnw Sales\n```\n\n## Recipes\n\n### Call a tool with real arguments\n\n`tools describe` prints a tool's full description and input JSON schema. `tools call` runs the tool with arguments that match it:\n\n```console\n$ amcp tools describe shopify_search_orders\n$ amcp tools call shopify_search_orders \\\n --args '{\"query\":\"financial_status:paid created_at:>=2026-11-01\",\"first\":2}'\n{\n \"orders\": {\n \"pageInfo\": { \"hasNextPage\": true, \"endCursor\": \"eyJsYXN0X2lkIjo2…\" },\n \"nodes\": [\n {\n \"name\": \"#1043\",\n \"displayFinancialStatus\": \"PAID\",\n \"displayFulfillmentStatus\": \"UNFULFILLED\",\n \"currentTotalPriceSet\": { \"shopMoney\": { \"amount\": \"412.80\", \"currencyCode\": \"EUR\" } },\n \"customer\": { \"displayName\": \"Kellerhaus GmbH\" }\n },\n …\n```\n\nArguments can also come from a file (`--args @args.json`) or from stdin (`--args -`).\n\n### Pipe results into jq, cron and CI\n\nA tool's text output is its JSON on stdout. Errors go to stderr with a distinct exit code, so `amcp` composes like any Unix tool:\n\n```console\n$ amcp tools call shopify_search_orders \\\n --args '{\"query\":\"fulfillment_status:unfulfilled created_at:<2026-11-03\"}' \\\n | jq -r '.orders.nodes[] | [.name, .customer.displayName, .createdAt[:10]] | @tsv'\n#1038 Kellerhaus GmbH 2026-10-30\n#1035 Studio Lumen 2026-10-29\n#1031 Bäckerei Hofmann 2026-10-28\n```\n\nA daily job that posts late orders to Slack (the Slack connector sits on the same MCP server):\n\n```bash\n#!/usr/bin/env bash\n# late-orders.sh — run from cron: 0 8 * * 1-5\nset -euo pipefail\nSINCE=$(date -d '-2 days' +%F) # GNU date; on macOS: date -v-2d +%F\nLATE=$(amcp tools call shopify_search_orders \\\n --args \"{\\\"query\\\":\\\"fulfillment_status:unfulfilled created_at:<$SINCE\\\"}\" \\\n | jq -r '.orders.nodes[] | \"• \\(.name) — \\(.customer.displayName)\"')\n[ -z \"$LATE\" ] && exit 0\njq -n --arg text \"Orders waiting more than 2 days:\n$LATE\" '{channel: \"#fulfilment\", text: $text}' \\\n | amcp tools call slack_post_message --args - --yes\n```\n\n### Code mode: one program, many tool calls\n\n\n ![\"A](\"https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/packages/cli/assets/code-mode.png\")
\n