ContextForge CLI

A command-line interface for managing ContextForge MCP Gateway — seamlessly manage local or hosted MCP servers, tools, resources, prompts, and Agent-to-Agent services.

Part of the ContextForge ecosystem by IBM

Quick Start

Installation

pip install git+https://github.com/contextforge-org/contextforge-cli.git

First Steps

# Authenticate with your gateway
cforge login

# List available tools
cforge tools list

# Start a local gateway server
cforge serve

Features

Commands

Authentication & Settings

cforge login              # Authenticate with the gateway
cforge logout             # Clear saved credentials
cforge whoami             # Show current user
cforge version            # Display CLI version

Resource Management

To see the full set of available comands, use cforge --help. To see the options for a sub command, use cforge <command> --help.

Here are some examples:

# Tools
cforge tools list [--mcp-server-id ID] [--json]
cforge tools get <tool-id>
cforge tools create [file.json]
cforge tools toggle <tool-id>

# Resources
cforge resources list
cforge resources create [file.json]

# Prompts
cforge prompts list
cforge prompts execute <prompt-id>

# MCP Servers
cforge mcp-servers list
cforge mcp-servers update <mcp-server-id> [file.json]

Server Operations

# Start the gateway server
cforge serve [--host HOST] [--port PORT] [--reload]

# Configuration management
cforge export [--output file.json]
cforge import <file.json>
cforge support-bundle      # Generate diagnostics

Output Options

Most commands support:

• --json — Output raw JSON instead of formatted tables
• --mcp-server-id — Filter by specific MCP server
• --active-only — Show only enabled items

Configuration

Environment Variables

Additionally, all configuration in mcpgateway can be set via the environment or via CONTEXTFORGE_HOME/.env. For full details, see the docs.

Development

Setup

git clone https://github.com/contextforge-org/contextforge-cli.git
cd contextforge-cli
pip install -e ".[dev]"

Running Tests

pytest

Related Projects

• ContextForge MCP Gateway — The gateway server this CLI manages
• MCP Specification — Model Context Protocol documentation

License

Apache 2.0 — See LICENSE for details.

Contributing

Contributions welcome! Please see the ContextForge contributing guidelines.