mcpgod/cli: Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.

Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God.

MCPGod is a CLI tool designed to help developers manage MCP servers with speed and ease. Whether you need to add, run, list, or remove servers—or even interact with server tools—MCPGod provides a streamlined interface to handle all these tasks on Windows, macOS, or Linux.

• Client Management
  Add, remove, and list MCP servers for specific clients.
• Tool Discovery
  List every tool on any MCP server.
• Tool Calling
  Run any tool on any MCP server directly from the command line.
• Tool/Client Permissions
  Allow or block specific tools for specific clients.
• Detailed Logging
  Log every server run from every client, with timestamps and clean output for easy debugging.

Install mcpgod globally using npm:

Verify the installation:

Or run directly with npx.

Access the CLI with the god command (or npx -y mcpgod). Below are some common examples:

• Add a Server to a Client

  Add an MCP server to a client (e.g., Claude) with god add -c :

  god add @modelcontextprotocol/server-everything -c claude

• Only Add Specific Tools to a Client

  Only add specific tools to a client with god add -c --tools=:

  god add @modelcontextprotocol/server-everything -c claude --tools=echo,add

• List Servers for a Client

  List all configured servers for a specific client with god list -c :

• Remove a Server

  Remove an MCP server from your client’s configuration with god remove -c :

  god remove @modelcontextprotocol/server-everything -c claude

• Run a Server

  Run a server process with detailed logging with god run :

  god run @modelcontextprotocol/server-everything

• List Available Tools for a Server

  Display the list of tools available on a server with god tools :

  god tools @modelcontextprotocol/server-everything

• Call a Specific Tool on a Server

  Interact with a tool by passing key-value properties with god tool [optional parameters]:

  god tool @modelcontextprotocol/server-everything add a=59 b=40

For a complete list of commands and options, simply run:

When running a server, mcpgod logs output to:

Each log file is organized by server name and timestamped to help you trace and debug any issues that arise.

mcpgod is built with the Oclif framework and uses the Model Context Protocol SDK for robust interactions with MCP servers.

Clone the repository to get started with development:

git clone https://github.com/mcpgod/cli.git
cd mcpgod
npm install

Run the CLI in development mode:

Contributions are always welcome! To contribute:

1. Fork the repository.
2. Create a branch:

   git checkout -b feature/your-feature

3. Make your changes, and commit them:

   git commit -am 'Add new feature'

4. Push your branch:

   git push origin feature/your-feature

5. Open a Pull Request on GitHub.

This project is licensed under the MIT License.

Keep your files stored safely and securely with the SanDisk 2TB Extreme Portable SSD. With over 69,505 ratings and an impressive 4.6 out of 5 stars, this product has been purchased over 8K+ times in the past month. At only $129.99, this Amazon’s Choice product is a must-have for secure file storage.

Help keep private content private with the included password protection featuring 256-bit AES hardware encryption. Order now for just $129.99 on Amazon!

Help Power Techcratic’s Future – Scan To Support

If Techcratic’s content and insights have helped you, consider giving back by supporting the platform with crypto. Every contribution makes a difference, whether it’s for high-quality content, server maintenance, or future updates. Techcratic is constantly evolving, and your support helps drive that progress.

As a solo operator who wears all the hats, creating content, managing the tech, and running the site, your support allows me to stay focused on delivering valuable resources. Your support keeps everything running smoothly and enables me to continue creating the content you love. I’m deeply grateful for your support, it truly means the world to me! Thank you!