Promptz

by cremich

313 downloads
Not rated
GitHub

About

Provides a bridge to the promptz.dev platform, enabling direct access and seamless integration of prompts into developer workflows without manual copy-pasting.

Details

Author
cremich
Repository
cremich/promptz-mcp
Downloads
313
License
MIT No Attribution
Categories
Developer Tools, AI, Productivity, Design, Infrastructure, Frontend, Other
Tags
#integration

The promptz.dev MCP Server provides two main capabilities:

1. Prompts - Executable functions to search and execute prompts.
2. Rules - Executable functions to search for project rules and by integrating with other tools adding/updating them in your workspace.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Promptz
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @promptz/mcp
    Environment
    • PROMPTZ_API_KEY your-api-key-from-promptz.dev
    • PROMPTZ_API_URL your-api-url-from-promptz.dev

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Once the server is connected to Amazon Q Developer, you can use it with natural language like:

- "Search for CLI prompts about JavaScript"
- "Show me the prompt called 'React Component Documentation'"
- "Use the React Component Documentation prompt to improve my documentation"
- "Find project rules for CDK Development"
- "Add the CDK Project Structure project rule to my workspace"

Open the Amazon Q Developer MCP client settings file located at ~/.aws/amazonq/mcp.json

1. Clone the repository:

git clone https://github.com/cremich/promptz-mcp.git
cd promptz-mcp

2. Install dependencies and build:

npm install
npm run build

3. Add the following configuration to your MCP client's settings file:

{
  "mcpServers": {
    "promptz.dev": {
      "command": "node",
      "args": ["/path/to/promptz-mcp/build/index.js"],
      "env": {
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev",
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

PROMPTZ_API_URL="your-api-url" PROMPTZ_API_KEY="your-api-key" npm run inspector
```

The Inspector will provide a URL to access debugging tools in your browser.

npm install

search_prompts

Search for executable prompts based on a query (string) provided by the user.

execute_prompt

Execute a specific prompt by name (string) to perform an action.

search_rules

Search for project rules based on a query (string) provided by the user.

add_rule

Add a specific project rule (string) to the user's workspace.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "promptz": {
            "env": {
                "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev",
                "PROMPTZ_API_URL": "your-api-url-from-promptz.dev"
            },
            "args": [
                "-y",
                "@promptz/mcp"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": {
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev",
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev"
    },
    "args": [
        "-y",
        "@promptz/mcp"
    ],
    "command": "npx"
}

Macos

{
    "env": {
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev",
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev"
    },
    "args": [
        "-y",
        "@promptz/mcp"
    ],
    "command": "npx"
}

Windows

{
    "env": {
        "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev",
        "PROMPTZ_API_URL": "your-api-url-from-promptz.dev"
    },
    "args": [
        "/c",
        "npx",
        "-y",
        "@promptz/mcp"
    ],
    "command": "cmd"
}

Access prompts from promptz.dev directly within Amazon Q Developer.

This MCP server allows to access prompts from the promptz.dev API without copy-pasting, reducing context switching and friction in your development workflow.

The promptz.dev MCP Server provides two main capabilities:
- Prompts- Executable functions to search and execute prompts.
- Rules- Executable functions to search for project rules and by integrating with other tools adding/updating them in your workspace.

Once the server is connected to Amazon Q Developer, you can use it with natural language like:

- "Search for CLI prompts about JavaScript"
- "Show me the prompt called 'React Component Documentation'"
- "Use the React Component Documentation prompt to improve my documentation"
- "Find project rules for CDK Development"
- "Add the CDK Project Structure project rule to my workspace"
- Navigate tohttps://promptz.dev/mcp
- Copy the MCP settings like API Key, API URL or the sample MCP configuration snippet.

Open the Amazon Q Developer MCP client settings file located at~/.aws/amazonq/mcp.json

The easiest way to use the server is with npx, which doesn't require installation:
- Add the following configuration to your Amazon Q Developer MCP client's settings file:

{ "mcpServers": { "promptz.dev": { "command": "npx", "args": ["-y", "@promptz/mcp"], "env": { "PROMPTZ_API_URL": "your-api-url-from-promptz.dev", "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev" }, "disabled": false, "autoApprove": [] } } }
git clone https://github.com/cremich/promptz-mcp.git cd promptz-mcp

- Add the following configuration to your MCP client's settings file:

{ "mcpServers": { "promptz.dev": { "command": "node", "args": ["/path/to/promptz-mcp/build/index.js"], "env": { "PROMPTZ_API_URL": "your-api-url-from-promptz.dev", "PROMPTZ_API_KEY": "your-api-key-from-promptz.dev" }, "disabled": false, "autoApprove": [] } } }

If you encounter issues with the server:
- Check that your API credentials are correct
- Ensure the server is properly configured in your MCP client
- Look for error messages in the logs located ad~/.promptz/logs/mcp-server.log
- Use the MCP Inspector for debugging:

# Run with environment variables PROMPTZ_API_URL="your-api-url" PROMPTZ_API_KEY="your-api-key" npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

For those who want to contribute or modify the server:

# Install dependencies npm install # Build the server npm run build # For development with auto-rebuild npm run watch # Run tests npm test

- This server only provides read access to prompts and does not implement any write operations
- API credentials are stored in your MCP client's configuration file
- All communication with the promptz.dev API is done via HTTPS
- The server logs to a file in your home directory (~/.promptz/logs/mcp-server.log)

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

MCP bridge that lets Claude Code delegate heavy tasks to the Antigravity CLI (agy) — purpose-built tools, model routing with fallback, session continuity, and output truncation to save Claude's context and tokens.

Local agent workbench bundling OpenHands, Goose, Aider, and ashlrcode against one local LLM, with ashlr-plugin MCP servers pre-wired.

A collection of MCP servers that provide cognitive enhancement tools for large language models.

Transforms linear AI reasoning into structured, auditable thought graphs, enabling language models to externalize their reasoning process as a directed acyclic graph (DAG).

An open-source desktop application for hosting MCP servers that integrates with function-calling LLMs.

A terminal AI chat interface for any LLM model, with file context, MCP, and deployment support.

Unified MCP server providing access to Claude Code, Codex, and Gemini CLIs through a single gateway. Features multi-LLM orchestration, persistent session management, async job execution with polling, approval gates, retry with circuit breakers, and token optimization. Install: npx -y llm-cli-gateway

a complete and intuitive SDK for building MCP Servers, MCP Agents, and LLM integrations (OpenAI, Claude, Gemini) with minimal effort. It abstracts all the complexity of the MCP protocol, provides an intelligent agent with automatic model routing, and includes a universal client for external APIs all through a single, simple, and powerful interface. Perfect for chatbots, enterprise automation, internal system integrations, and rapid development of MCP-based ecosystems.

A CLI host application that enables Large Language Models (LLMs) to interact with external tools through the Model Context Protocol (MCP).

A TypeScript agent that integrates MCP servers with Ollama, allowing AI models to use various tools through a unified interface.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.