promptforge-mcp 0.1.0

Prompt Forge MCP server for secure LLM gateway access

Prompt Forge MCP Server

Python MCP server that exposes Prompt Forge secure gateway tools over the Model Context Protocol.

Install

pip install promptforge-mcp

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "promptforge": {
      "command": "promptforge-mcp",
      "env": {
        "PROMPTFORGE_API_KEY": "your-api-key",
        "PROMPTFORGE_ORG_ID": "your-org-id",
        "PROMPTFORGE_ADMIN_TOKEN": "your-admin-token"
      }
    }
  }
}

Claude Code

claude mcp add promptforge -- promptforge-mcp

Then set environment variables in your shell before launching.

Run directly (stdio)

export PROMPTFORGE_API_KEY="your-api-key"
promptforge-mcp

Run as HTTP/SSE server

promptforge-mcp --http
# or
MCP_TRANSPORT=http MCP_PORT=8765 promptforge-mcp

Environment Variables

Variable	Required	Default	Description
PROMPTFORGE_API_KEY	Yes (for gateway)	—	API key for gateway requests
PROMPTFORGE_ADMIN_TOKEN	Yes (for admin tools)	—	Token for secure mode and audit tools
PROMPTFORGE_ORG_ID	Yes (for admin tools)	—	Organization ID
PROMPTFORGE_API_BASE	No	https://api.secureprompt.tech	API base URL
PROMPTFORGE_GATEWAY_URL	No	{API_BASE}/v1/gateway/requests	Gateway endpoint
PROMPTFORGE_TIMEOUT	No	30	Request timeout in seconds
PROMPTFORGE_MCP_TOOLS_PATH	No	—	Override path for tool definitions JSON
MCP_RATE_LIMIT_PER_MINUTE	No	60	Rate limit per minute
MCP_TRANSPORT	No	stdio	Transport mode (stdio or http)
MCP_HOST	No	0.0.0.0	SSE server host
MCP_PORT	No	8765	SSE server port

MCP Tools

Tool	Description
promptforge.secure_generate	Send a request through the secure LLM gateway
promptforge.redact_and_tokenize	Tokenize sensitive entities using Secure Mode
promptforge.policy_dry_run	Evaluate an egress policy without executing a call
promptforge.audit_query	Query audit logs (admin-only)
promptforge.detokenize	Detokenize content with a token vault reference

Docker

docker build -t promptforge-mcp .
docker run -p 8765:8765 \
  -e PROMPTFORGE_API_KEY=your-key \
  -e PROMPTFORGE_ORG_ID=your-org \
  -e PROMPTFORGE_ADMIN_TOKEN=your-token \
  promptforge-mcp

License

MIT