Skip to main content
Glama
Holdifyio

holdify-mcp

Official
by Holdifyio
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

@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

Related MCP server: StashDog MCP Server

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers