clarifyprompt-mcp/server.json at main · LumabyteCo/clarifyprompt-mcp · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.LumabyteCo/clarifyprompt",
  "description": "Context-aware MCP prompt compiler with a composable pipeline: clarify_with_user → ground_prompt OR optimize_prompt → critique_prompt, all in one call via compose_prompt. Persistent memory, knowledge packs, explicit token-budget curation, reflective learning, 58+ AI platforms, workspace signals (CLAUDE.md / AGENTS.md / .cursorrules), reasoning-model support. Deterministic eval harness ships with the package.",
  "repository": {
    "url": "https://github.com/LumabyteCo/clarifyprompt-mcp",
    "source": "github"
  },
  "version": "1.5.2",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "clarifyprompt-mcp",
      "version": "1.5.2",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "LLM API endpoint URL (OpenAI-compatible or Anthropic)",
          "isRequired": true,
          "format": "string",
          "isSecret": false,
          "name": "LLM_API_URL"
        },
        {
          "description": "API key for the LLM provider (not needed for local Ollama)",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "LLM_API_KEY"
        },
        {
          "description": "Model name/ID to use for optimization",
          "isRequired": true,
          "format": "string",
          "isSecret": false,
          "name": "LLM_MODEL"
        },
        {
          "description": "Canonical data directory for traces, persistent memory (SQLite), knowledge packs, and config (default: ~/.clarifyprompt, respects XDG_DATA_HOME). Supersedes CLARIFYPROMPT_DATA_DIR and CLARIFYPROMPT_CONFIG_DIR from 1.2.0+.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "CLARIFYPROMPT_HOME"
        },
        {
          "description": "Legacy alias for CLARIFYPROMPT_HOME (still works; emits a one-line deprecation hint).",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "CLARIFYPROMPT_DATA_DIR"
        },
        {
          "description": "Legacy alias for CLARIFYPROMPT_HOME (pre-1.2 custom-platform dir). Still works; emits a one-line deprecation hint. Will be removed in 2.x.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "CLARIFYPROMPT_CONFIG_DIR"
        },
        {
          "description": "Set to 1 to silence the one-line deprecation hint when CLARIFYPROMPT_CONFIG_DIR / CLARIFYPROMPT_DATA_DIR are used.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "CLARIFYPROMPT_SUPPRESS_LEGACY_WARN"
        },
        {
          "description": "Trace mode: off | local | otel (default: local). Traces are strictly local JSONL; nothing is uploaded.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "CLARIFYPROMPT_TRACE"
        },
        {
          "description": "Embedding endpoint URL for semantic memory + knowledge-pack retrieval (default: falls back to LLM_API_URL — Ollama users just work).",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBED_API_URL"
        },
        {
          "description": "Embedding API key (default: falls back to LLM_API_KEY; not needed for local Ollama).",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "EMBED_API_KEY"
        },
        {
          "description": "Embedding model name (default: nomic-embed-text:v1.5 — pull it with `ollama pull nomic-embed-text`). Switch to text-embedding-3-small for OpenAI, voyage-3 for Voyage, embed-english-v3.0 for Cohere.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBED_MODEL"
        },
        {
          "description": "Embedding dimension (default: 768 for nomic-embed-text). Set to match your embedding model's output: 1536 for text-embedding-3-small, 1024 for voyage-3, etc.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "EMBED_DIMENSION"
        },
        {
          "description": "Web-search provider for the optional context-enrichment path. One of: tavily | brave | serper | serpapi | exa | searxng. Default: tavily.",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SEARCH_PROVIDER"
        },
        {
          "description": "API key for the configured SEARCH_PROVIDER. Not needed for self-hosted SearXNG.",
          "isRequired": false,
          "format": "string",
          "isSecret": true,
          "name": "SEARCH_API_KEY"
        },
        {
          "description": "Search-provider API URL. Only needed for self-hosted SearXNG (point at your instance).",
          "isRequired": false,
          "format": "string",
          "isSecret": false,
          "name": "SEARCH_API_URL"
        }
      ]
    }
  ]
}