holdify-mcp

@holdify/mcp

MCP (Model Context Protocol) server for the Holdify API. Enables AI assistants like Claude and Cursor to manage API keys, check usage, and debug authentication issues.

Installation

npm install -g @holdify/mcp
# or
npx @holdify/mcp

Configuration

Set the following environment variables:

# Required: Your Holdify project API key
export HOLDIFY_API_KEY=hld_proj_live_xxx

# Optional: Custom API URL (defaults to https://api.holdify.io)
export HOLDIFY_API_URL=https://api.holdify.io

# Optional: Request timeout in ms (defaults to 30000)
export HOLDIFY_TIMEOUT=30000

Usage with Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "holdify": {
      "command": "npx",
      "args": ["@holdify/mcp"],
      "env": {
        "HOLDIFY_API_KEY": "hld_proj_live_your-key-here"
      }
    }
  }
}

Usage with Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "holdify": {
      "command": "npx",
      "args": ["@holdify/mcp"],
      "env": {
        "HOLDIFY_API_KEY": "hld_proj_live_your-key-here"
      }
    }
  }
}

Available Features

Resources (Read-only data)

| Resource | URI | Description | |----------|-----|-------------| | Project Summary | holdify://project | Project overview with plan, limits, and key count | | API Keys List | holdify://keys | List all API keys for the project | | Key Details | holdify://keys/{keyId} | Get detailed info about a specific key | | Usage Stats | holdify://usage | Current usage statistics (30-day period) | | Audit Log | holdify://audit | Recent audit events (last 50) |

Tools (Actions)

| Tool | Description | Input | |------|-------------|-------| | create_api_key | Create a new API key | name, environmentId, scopes? | | verify_key | Verify if an API key is valid | key, resource?, units? | | revoke_key | Permanently revoke an API key | keyId | | rotate_key | Rotate an API key (24h grace period) | keyId | | get_usage | Get usage statistics | period? (24h, 7d, 30d, 90d) |

Prompts (Templates)

| Prompt | Description | Arguments | |--------|-------------|-----------| | setup_api_auth | Help setting up API authentication | framework, language? | | debug_key_issue | Debug API key problems | errorMessage?, keyPrefix? |

Example Interactions

Check project status

"What's my current usage and how many keys do I have?"

The AI will read holdify://project to get plan info, usage stats, and key count.

Create a new API key

"Create a new API key called 'Production Server' for environment env_abc123"

The AI will use the create_api_key tool and return the new key (save it immediately!).

Debug authentication issues

"My API key isn't working, I'm getting a 401 error"

The AI will use the debug_key_issue prompt to guide you through troubleshooting.

Check rate limits

"Am I close to my rate limit?"

The AI will use get_usage to check your current usage and quota status.

Security

• API keys are masked in responses (only prefix + last 4 chars shown)
• Full keys are only returned on creation/rotation
• All operations are scoped to your project via the project API key

Development

# Install dependencies
pnpm install

# Build the package
pnpm build

# Run locally
HOLDIFY_API_KEY=your-key node dist/index.js

License

MIT