# Mcpgod Cli > Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God. - **Type:** MCP server - **Install:** `agentstack add mcp-mcpgod-cli` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [mcpgod](https://agentstack.voostack.com/s/mcpgod) - **Installs:** 0 - **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [mcpgod](https://github.com/mcpgod) - **Source:** https://github.com/mcpgod/cli - **Website:** https://github.com/mcpgod/cli ## Install ```sh agentstack add mcp-mcpgod-cli ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # MCPGod > Fine-grained control over model context protocol (MCP) clients, servers, and tools. Context is God. [](https://oclif.io) [](https://npmjs.org/package/mcpgod) [](https://npmjs.org/package/mcpgod) [](LICENSE) [](coverage/lcov-report/index.html) ## Overview **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. ## Features - **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. ## Installation Install **mcpgod** globally using `npm`: ```sh npm install -g mcpgod ``` Verify the installation: ```sh mcpgod --version ``` Or run directly with `npx`. ```sh npx -y mcpgod ``` ## Usage Access the CLI with the `mcpgod` 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 `mcpgod add -c `: ```sh mcpgod add @modelcontextprotocol/server-everything -c claude ``` - **Only Add Specific Tools to a Client** Only add specific tools to a client with `mcpgod add -c --tools=`: ```sh mcpgod add @modelcontextprotocol/server-everything -c claude --tools=echo,add ``` - **List Servers for a Client** List all configured servers for a specific client with `mcpgod list -c `: ```sh mcpgod list -c claude ``` - **Remove a Server** Remove an MCP server from your client's configuration with `mcpgod remove -c `: ```sh mcpgod remove @modelcontextprotocol/server-everything -c claude ``` - **Run a Server** Run a server process with detailed logging with `mcpgod run `: ```sh mcpgod run @modelcontextprotocol/server-everything mcpgod run ./mcp-server.py mcpgod run ./mcp-server-node.mjs ``` - **List Available Tools for a Server** Display the list of tools available on a server with `mcpgod tools `: ```sh mcpgod tools @modelcontextprotocol/server-everything mcpgod tools ./mcp-server.py mcpgod tools ./mcp-server-node.mjs ``` - **Call a Specific Tool on a Server** Interact with a tool by passing key-value properties with `mcpgod tool [optional parameters]`: ```sh mcpgod tool @modelcontextprotocol/server-everything add a=59 b=40 mcpgod tool ./mcp-server.py echo message=hi mcpgod tool ./mcp-server-node.mjs echo message=hi ``` For a complete list of commands and options, simply run: ```sh mcpgod --help ``` ## Logging When running a server, **mcpgod** logs output to: ```plaintext ~/mcpgod/logs ``` Each log file is organized by server name and timestamped to help you trace and debug any issues that arise. ## Development **mcpgod** is built with the [Oclif](https://oclif.io) framework and uses the [Model Context Protocol SDK](https://modelcontextprotocol.org) for robust interactions with MCP servers. Clone the repository to get started with development: ```sh git clone https://github.com/mcpgod/cli.git cd mcpgod npm install ``` Run the CLI in development mode: ```sh ./bin/dev ``` ## Publishing Automatic publishing is handled by the `version, tag and github release` workflow. A new npm version is published whenever a version bump is merged into the `main` branch. The workflow can also be triggered manually from the **Actions** tab. To enable publishing, set the following repository secrets: - `NPM_TOKEN` – authentication token for npm. - `GH_EMAIL` and `GH_USERNAME` – used by the README update step. Once the secrets are configured, pushing a new version or running the workflow manually will build the project, create a GitHub release and publish the package to npm. ### Linting workflows Before committing changes to workflows, you can lint them locally: ```sh npm run lint:workflows ``` ## Contributing Contributions are always welcome! To contribute: 1. **Fork** the repository. 2. **Create a branch**: ```sh git checkout -b feature/your-feature ``` 3. **Make your changes**, and commit them: ```sh git commit -am 'Add new feature' ``` 4. **Push** your branch: ```sh git push origin feature/your-feature ``` 5. **Open a Pull Request** on GitHub. ## License This project is licensed under the [MIT License](LICENSE). --- ## Additional Resources - [Oclif CLI Framework](https://oclif.io) - [Model Context Protocol](https://modelcontextprotocol.org) - [npm Package mcpgod](https://npmjs.org/package/mcpgod) --- ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [mcpgod](https://github.com/mcpgod) - **Source:** [mcpgod/cli](https://github.com/mcpgod/cli) - **License:** MIT - **Homepage:** https://github.com/mcpgod/cli Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-mcpgod-cli - Seller: https://agentstack.voostack.com/s/mcpgod - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.