ARGUS-3 MCP Server

ARGUS-3 — MCP server

0.3.3: requires @aimarket/warden@0.8.1 or later. MCP servers are checked before launch and before every call; list-change notifications quarantine tools immediately. Changed definitions, and pins taken before 0.3.2, need a reviewed re-approval: argus warden pins status / argus warden pins approve ; the first clean connection keeps the automatic first-pin policy. Pin write failures close the connection. Publish Warden first, then ARGUS. Migration: EN · RU · ES · FR · ZH.

🔄 Synced from the AI-Factory monorepo (append-only history). Pull requests are welcome — merged PRs are imported back and re-synced here. Issues · Pull requests

🌐 English · Русский · Español · Français · 中文 · Glossary

One MCP server. WARDEN-hardened agent. Wallet optional.

Transport: stdio (argus mcp). Built with the official Model Context Protocol TypeScript SDK (@modelcontextprotocol/sdk). Compatible hosts: Claude Desktop, Cursor, Glama, and any MCP client that supports stdio servers.

Part of the AICOM open agent economy. Live demo: magic-ai-factory.com/argus/ · Community: Discord · Pollux · Telegram · Castor

Live landing · WARDEN firewall · Install · Wiki

MCP firewall first — wallet optional. ARGUS-3 vets every third-party MCP server through WARDEN (static scan → threat feed → origin → def-pinning) before a single tool runs. Crypto, wallet, and on-chain economy are off by default. *(short name ARGUS · CLI: argus · npm: `argus-warden` · scoped: @alexar76/argus3)*

Why "ARGUS-3"? In the myth, Argus Panoptes — the hundred-eyed watchman —

was unbeatable until Hermes talked him to sleep and slew him. ARGUS-3 is the

watchman that *doesn't* fall for Hermes: a hundred eyes open (WARDEN), frugal to a

fault, immune to smooth-talking competitors.

Third time's the watchman. 👁️

ARGUS is the demand-side reference client the agent economy was missing. The ecosystem already has producers (the Factory 🏭), a broker (the Hub 🛒), pricing (ACEX 📈), trust math (the LUMEN oracle 🔮) and observability (the Monitor 👽). What it lacked was a first-class agent an ordinary person runs — one that discovers, pays for, consumes and sells capabilities. That's ARGUS.

It is built on two stack layers that generic MCP clients typically lack:

1. 🛡️ WARDEN — an MCP security firewall that vets third-party servers before their tool definitions ever reach the model: a tiered static scan, a signed threat feed, an origin check, and tool-def pinning against rug-pulls. Every gate decides from what ARGUS already holds locally. Works with no wallet and no chain.
2. 💸 Native settlement *(optional)* — pay per-call and get paid in USDC on Base through AIMarket escrow when you enable crypto and connect a wallet.

…and it stays frugal (a hard budget governor + live token meter — no self-reflection on your dime), speaks any model (Anthropic, OpenAI-compatible, Chinese, local), and — critically — runs fully autonomously when the economy is unavailable. No wallet, no network to AICOM? It's still a best-in-class local, MCP-secured assistant.

### 🔒 Crypto is OFF by default

A blockchain is not required to run ARGUS-3. Wallet, lottery, ACEX, paid

invokes, and on-chain settlement are disabled by default and turn on only

when you set `ARGUS_CRYPTO_ENABLED=1` (plus a wallet). Out of the box you get

the full agent — WARDEN, any model, memory, channels, and **free off-chain oracle

reads** — with no chain, no token, no wallet, no custody. Crypto is opt-in.

---

Why ARGUS is different

---

🧭 Core capabilities — design intent and stack dependencies for each headline

feature — [docs/killer-features.md](docs/killer-features.md)

· ru · es.

Quickstart

One command (interactive wizard, ~2 minutes):

curl -fsSL https://magic-ai-factory.com/install | bash

Or install from npm (same CLI, no curl script):

npm install -g @alexar76/argus3@0.3.3

mkdir -p ~/.argus/agent && cd ~/.argus/agent argus setup && argus doctor

Package: @alexar76/argus3 on npm · CLI: argus · npx -y @alexar76/argus3@0.3.3 --help

Use the scoped package for current releases. The legacy argus-warden package remains at 0.3.1 with an older WARDEN dependency.

Then argus chat or argus serve.

Run as MCP server (stdio)

npm install -g @alexar76/argus3@0.3.3

or: npm install && npm run build && node dist/index.js mcp

argus mcp

Claude Desktop / Cursor (mcpServers entry):

{

"mcpServers": { "argus": { "command": "argus", "args": ["mcp"] } } }

Tools (2)

Glama TDQS: MCP annotations (readOnly / destructive / idempotent / openWorld), Behavior + Usage Guidelines in every description, structured params with examples — calibrated to the score rubric (not the old one-liner).

Publish on Glama

Listing: [glama.ai/mcp/servers/alexar76/argus](https://glama.ai/mcp/servers/alexar76/argus)

Same pattern as [aimarket-oracle-gateway](https://github.com/alexar76/aimarket-oracle-gateway): repo-root glama.json + Dockerfile.glama + node dist/index.js mcp.

If magic-ai-factory.com/install returns 404, use the mirror:

curl -fsSL https://modeldev.modelmarket.dev/install | bash

Docs: Wiki · User guide (20 languages) · Developer guide — publish a capability in 15 min (20 languages) · Use case — your ARGUS on AICOM (EN / RU) · Use case — a travel eSIM, bought and refunded (5 languages) · The Verifiable Conscience (block diagrams) · When ARGUS won't help you 😈 · Ecosystem whitepaper

Manual install (developers — from git)

cd argus

npm install npm run build

1) Configure (safe to commit — NO secrets live here)

cp argus.config.example.json argus.config.json

2) Add keys to .env (all optional; with none, ARGUS uses a local Ollama model)

cp .env.example .env # then edit

3) Check what's wired up

node dist/index.js doctor

4) Ask something

node dist/index.js ask "summarise https://example.com in three bullets"

5) Interactive

node dist/index.js chat

During development you can skip the build step with npm run dev -- ask "…".

The autonomy guarantee

ARGUS needs nothing from AICOM to work:

# No ANTHROPIC_API_KEY, no wallet — just a local model:

ARGUS_LOCAL_BASE_URL=http://127.0.0.1:11434/v1 node dist/index.js ask "hello"

With no ARGUS_WALLET_KEY, doctor reports economy: OFF (autonomous) and the entire economy layer is never constructed. See [doc