MCP CLI

The arrowflow-mcp CLI is the single entrypoint for all ArrowFlow MCP (Model Context Protocol) servers and admin operations. It lives in ai-toolkit/mcp-rag-server/ and exposes three MCP servers plus direct CLI commands for user management.

Installation

cd ai-toolkit/mcp-rag-server
npm install

Quick Start

# Show all commands
node arrowflow-mcp.js --help

# Validate your environment
node arrowflow-mcp.js doctor

# Start a server
node arrowflow-mcp.js serve rag
node arrowflow-mcp.js serve diagram
node arrowflow-mcp.js serve admin

MCP Servers

RAG Server

Semantic documentation search, code examples, pattern suggestions, and approach validation.

node arrowflow-mcp.js serve rag

Tools: rag_search, rag_get_examples, rag_suggest_patterns, rag_validate_approach, rag_get_stats

Environment:

• RAG_DB_PATH — path to the RAG SQLite database (auto-detected if not set)

Diagram Server

Azure service catalog search, diagram creation, and listing.

node arrowflow-mcp.js serve diagram

Tools: search_catalog, create_diagram, list_diagrams

Environment:

• ARROWFLOW_API_URL — backend base URL (default: http://localhost:3000)

Admin Server

User plan and credit management for operators and agents.

node arrowflow-mcp.js serve admin

Tools:

Environment:

• ARROWFLOW_API_URL — backend base URL (default: http://localhost:3000)
• ADMIN_API_KEY — required — the admin API key for authentication

Admin CLI Commands

Direct command-line interface for credit operations without starting an MCP server. Useful for one-off operations and scripts.

Required environment variables:

• ARROWFLOW_API_URL — e.g. https://app.arrowflow.app
• ADMIN_API_KEY — admin API key (stored as ACA secret admin-api-key)

View user plan

arrowflow-mcp admin get-plan <userId>

Example:

$ arrowflow-mcp admin get-plan user_2xExampleAbcDeFgHiJkLmNoPqR
User:    user_2xExampleAbcDeFgHiJkLmNoPqR
Tier:    free
Balance: 5000
Monthly: 0
Reset:   2026-06-02T04:20:10.082Z

Reset user credits

Resets credits to the tier's initial allotment. If --tier is omitted, uses the user's current tier.

arrowflow-mcp admin reset-credits <userId> [--tier free|starter|pro|enterprise]

Example:

$ arrowflow-mcp admin reset-credits user_2xExampleAbcDeFgHiJkLmNoPqR --tier free
✅ Credits reset for user_2xExampleAbcDeFgHiJkLmNoPqR
   Tier: free
   New balance: 5000

Add or remove credits

Use a positive number to grant, negative to deduct. Optionally provide a reason for the audit log.

arrowflow-mcp admin add-credits <userId> <amount> [--reason <reason>]

Examples:

# Grant 5000 credits
arrowflow-mcp admin add-credits user_abc123 5000 --reason courtesy_grant

# Deduct 1000 credits
arrowflow-mcp admin add-credits user_abc123 -1000 --reason billing_correction

View credit events

Shows the audit log of credit changes for a user.

arrowflow-mcp admin credit-events <userId> [--limit <n>]

Example:

$ arrowflow-mcp admin credit-events user_2xExampleAbcDeFgHiJkLmNoPqR --limit 5
Credit events for user_2xExampleAbcDeFgHiJkLmNoPqR (3):

  5/2/2026, 4:20:10 AM  +5000  plan_reset
  5/1/2026, 8:15:22 PM  -200   agent_usage
  4/30/2026, 3:00:00 PM +5000  initial_grant

Host Configuration

Generate MCP registration JSON for different AI hosts:

# VS Code (Copilot Chat)
node arrowflow-mcp.js host-config vscode all

# Claude Desktop
node arrowflow-mcp.js host-config claude all

# Specific server only
node arrowflow-mcp.js host-config vscode admin

Copy the output into your host's MCP config file. For VS Code, this is .vscode/mcp.json or the user settings under mcp.servers.

Doctor

Validates the local environment:

node arrowflow-mcp.js doctor

Checks:

• MCP SDK installed
• RAG database accessible
• Diagram API target configured

Credit Tiers Reference

1 credit = 1,000 nano tokens. See the pricing page for full details.