npm package: @mcptoolgate/client
Description: MCP Tool Gate client for Claude Desktop - secure MCP tool governance with human-in-the-loop approvals
Author: Frozo AI
Latest version: 1.0.1

# MCP Tool Gate Client

<p align="center">
  <img src="https://mcptoolgate.com/icon-128.png" alt="MCP Tool Gate" width="128" height="128">
</p>

<p align="center">
  <strong>Enterprise-grade governance for AI tools</strong><br>
  Secure, approve, and audit every MCP tool call with human-in-the-loop guardrails.
</p>

<p align="center">
  <a href="https://mcptoolgate.com">Website</a> •
  <a href="https://app.mcptoolgate.com">Dashboard</a> •
  <a href="https://mcptoolgate.com/docs">Documentation</a>
</p>

---

## Quick Start

Add this to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "mcptoolgate": {
      "command": "npx",
      "args": ["-y", "@mcptoolgate/client"],
      "env": {
        "MCPTOOLGATE_API_KEY": "YOUR_API_KEY_HERE",
        "MCPTOOLGATE_URL": "https://app.mcptoolgate.com"
      }
    }
  }
}
```

### Config File Locations

| Platform | Path |
|----------|------|
| **macOS** | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| **Windows** | `%APPDATA%\Claude\claude_desktop_config.json` |
| **Linux** | `~/.config/Claude/claude_desktop_config.json` |

## Getting Your API Key

1. Sign up at [app.mcptoolgate.com](https://app.mcptoolgate.com)
2. Create a workspace
3. Go to **Settings → API Keys**
4. Click **Generate New Key**
5. Copy the key (shown only once!)

## Features

- 🛡️ **Policy-Based Approvals** — Define which AI actions need human approval
- 📋 **Complete Audit Trail** — Track every tool call for compliance
- 🔐 **Multi-Tenant Workspaces** — Isolate tools and policies across teams
- ⚡ **Dynamic Tool Discovery** — Tools from your dashboard appear instantly
- 📊 **Usage Metering** — Monitor and limit AI tool usage

## Supported Integrations

| Adapter | Capabilities |
|---------|-------------|
| **GitHub** | Search issues, create branches, open PRs, manage repos |
| **Jira** | Search, create, and update issues/tasks |
| **Slack** | Post messages, approval notifications |
| **HTTP/REST** | Connect any external API |

## How It Works

```
┌─────────────┐      STDIO      ┌──────────────────┐      HTTPS      ┌─────────────────┐
│   Claude    │ ←─────────────→ │ @mcptoolgate/cli │ ←─────────────→ │  MCP Tool Gate  │
│   Desktop   │                  │   (This Client)  │                  │    Backend      │
└─────────────┘                  └──────────────────┘                  └─────────────────┘
```

1. Claude requests a tool (e.g., `github.create_pr`)
2. This client forwards the request to MCP Tool Gate
3. Backend checks your policies
4. If approval required → You get a Slack/email notification
5. Approve or deny from the dashboard
6. Result returned to Claude

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `MCPTOOLGATE_API_KEY` | ✅ Yes | — | Your API key from the dashboard |
| `MCPTOOLGATE_URL` | No | `https://app.mcptoolgate.com` | Backend URL |

## Troubleshooting

### Tools not appearing?

1. Check your API key is correct
2. Verify the key isn't revoked in the dashboard
3. Check Claude Desktop logs:
   ```bash
   # macOS
   tail -f ~/Library/Logs/Claude/mcp*.log
   ```

### Execution failing?

1. Check tool adapter configuration in dashboard
2. Verify credentials (GitHub tokens, Jira API keys, etc.)
3. Check audit logs in dashboard for error details

## Pricing

| Plan | Price | Tool Calls |
|------|-------|------------|
| **Free** | $0/mo | 1,000/month |
| **Pro** | $49/mo | 50,000/month |
| **Enterprise** | Custom | Unlimited |

## Support

- 🌐 Website: [mcptoolgate.com](https://mcptoolgate.com)
- 📧 Email: hello@frozo.ai
- 💬 Issues: [GitHub Issues](https://github.com/ashish-frozo/frozo-mcpguard/issues)

## License

MIT © [Frozo AI](https://frozo.ai)