@enprompta/mcp-server

@enprompta/mcp-server

MCP (Model Context Protocol) server for Enprompta. Lets any MCP-capable coding agent — Claude Code, Cursor, Codex, and others — manage prompts, triage production traces, run evaluations, and verify that tracing is set up, directly through conversation.

Features

Prompts:

• save_prompt - Save a new version of a prompt with automatic versioning
• get_prompt - Retrieve a prompt by name (latest or specific version)
• get_versions - View version history for a prompt
• evaluate_prompt - Analyze prompt quality with AI-powered feedback
• improve_prompt - Generate improved variants of a prompt

Observability & evaluation:

• list_traces / get_trace / score_trace - Triage production traces and attach agent scores
• add_traces_to_dataset - Turn failing traces into a regression dataset
• run_evaluation / get_eval_results - Kick off an evaluation and read the results
• verify_setup - Confirm tracing is actually working after instrumenting an app (tracing is fail-silent, so this is the safety net that turns "added the code" into "a trace landed")

Installation

Using npx (Recommended)

No installation required - just configure Claude Desktop.

Global Installation

npm install -g @enprompta/mcp-server

Configuration

1. Get Your API Key

1. Sign up or log in at enprompta.com
2. Go to Dashboard > Settings > API Keys
3. Create a new API key

2. Connect your agent

Every MCP client takes the same server definition — run @enprompta/mcp-server over stdio with your key in the environment. Pick your agent:

Claude Code (CLI)

claude mcp add enprompta -- npx -y @enprompta/mcp-server
# then set ENPROMPTA_API_KEY in that shell/profile, or use --env:
# claude mcp add enprompta --env ENPROMPTA_API_KEY=ep_your_api_key -- npx -y @enprompta/mcp-server

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "enprompta": {
      "command": "npx",
      "args": ["-y", "@enprompta/mcp-server"],
      "env": { "ENPROMPTA_API_KEY": "ep_your_api_key_here" }
    }
  }
}

Cursor — add the same mcpServers block to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global).

Any other MCP client (Codex, Windsurf, Gemini CLI, …) — point it at the same command/args/env; consult that client's MCP config location.

3. Reload

Restart or reload the agent so it picks up the new server, then confirm the Enprompta tools are listed.

Usage Examples

Once configured, you can use natural language to interact with your prompt library:

Save a Prompt

"Save this prompt as 'code-reviewer':

You are an expert code reviewer. Analyze the provided code for:
1. Bugs and potential issues
2. Performance optimizations
3. Code style and best practices

Provide specific, actionable feedback."

Retrieve a Prompt

"Get my 'code-reviewer' prompt"

View Version History

"Show me the version history for 'code-reviewer'"

Evaluate a Prompt

"Evaluate this prompt for quality: [paste prompt]"

Compare Two Prompts

"Compare these two prompts and tell me which is better:
Prompt A: [first prompt]
Prompt B: [second prompt]"

Improve a Prompt

"Improve this prompt to be more specific: [paste prompt]"

Environment Variables

Variable	Required	Description
ENPROMPTA_API_KEY	Yes	Your Enprompta API key
ENPROMPTA_API_URL	No	API base URL (defaults to production)
DEBUG	No	Set to "true" for debug logging

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Type check
npm run typecheck

# Lint
npm run lint

# Test
npm run test

Troubleshooting

"ENPROMPTA_API_KEY environment variable is required"

Make sure you've added your API key to the Claude Desktop configuration file and restarted Claude Desktop.

Tools not appearing in Claude

1. Check that the configuration file path is correct for your OS
2. Verify the JSON syntax is valid
3. Restart Claude Desktop completely
4. Check Claude Desktop logs for errors

API Errors

• Verify your API key is valid and not expired
• Check your internet connection
• Ensure you have remaining API credits

Related

• Enprompta Dashboard - Full prompt management platform
• ChatGPT Plugin - Use Enprompta with ChatGPT
• API Documentation - REST API reference

License

MIT