@gildara/mcp-server

MCP server for Gildara — bring your prompt vault into any AI tool.

What it does

Connects your Gildara prompt library to Claude Desktop, Cursor, Windsurf, and any MCP-compatible tool. Your AI assistant can:

List prompts — browse your vault
Resolve prompts — get compiled system prompts with operating contracts assembled
Run prompts — execute with auto-repair (JSON schema validation + retry)
Create prompts — save new prompts from your AI session
Browse blueprints — see pre-built agent templates

Setup

1. Get your API key

For agents (no browser needed):

curl -X POST https://gildara.io/api/v1/provision \
  -H 'Content-Type: application/json' \
  -d '{"agent_label": "my-agent"}'

Returns an API key (pvk_...) instantly. No signup required.

For humans: Go to gildara.io/account and create an API key with the agent-standard preset.

2. Add to Claude Desktop

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

{
  "mcpServers": {
    "gildara": {
      "command": "npx",
      "args": ["-y", "@gildara/mcp-server"],
      "env": {
        "GILDARA_API_KEY": "pvk_your_key_here"
      }
    }
  }
}

3. Add to Cursor

Edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "gildara": {
      "command": "npx",
      "args": ["-y", "@gildara/mcp-server"],
      "env": {
        "GILDARA_API_KEY": "pvk_your_key_here"
      }
    }
  }
}

4. Add to Claude Code

claude mcp add gildara -- npx -y @gildara/mcp-server

Then set GILDARA_API_KEY in your environment.

Tools

Tool	Description
`list_prompts`	List all prompts in your vault
`get_prompt`	Get prompt details and operating contract config
`resolve_prompt`	Get compiled system prompt with contract sections
`run_prompt`	Run prompt through AI with auto-repair
`create_prompt`	Create a new prompt
`list_blueprints`	Browse agent blueprint templates

Example usage

Once connected, just tell your AI:

"List my Gildara prompts""Resolve my code-review-agent prompt with the code_diff variable""Run the security-audit prompt against this code""Save this prompt to my Gildara vault"

Environment variables

Variable	Required	Description
`GILDARA_API_KEY`	Yes	Your API key (`pvk_...`). Get one instantly: `curl -X POST https://gildara.io/api/v1/provision -H "Content-Type: application/json" -d '{"agent_label":"my-agent"}'`
`GILDARA_BASE_URL`	No	Override API URL (default: `https://gildara.io`)

Getting a key without a browser

No signup required. Run this to get an API key in seconds:

curl -X POST https://gildara.io/api/v1/provision \
  -H 'Content-Type: application/json' \
  -d '{"agent_label": "my-agent"}'

The response includes your api_key (starts with pvk_), a link code for your human owner, and your account ID. Set the key as GILDARA_API_KEY and you're ready.

License

MIT

@gildara/mcp-server