@gildara/mcp-server

@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, Claude Chat, and any MCP-compatible tool. Your AI assistant can:

• Search prompts — semantic search across your vault using Gemini embeddings.
• 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.
• Append memory — add persistent context or facts to your personal memory prompts.
• Browse blueprints — see 48+ pre-built agent templates.

Setup

No API key required on first run. As of v0.6.0, the MCP server auto-provisions a new agent account on first startup if no GILDARA_API_KEY is set, and caches the key at ~/.gildara/auto-key.json for future runs. Skip to "Add to Claude Desktop" below — zero curl required.

On first run, the server prints a link code to stderr (visible in Claude Desktop's MCP logs). Visit https://gildara.io/link?code=XXXXXX to pair the auto-provisioned agent with your human account and inherit your subscription tier.

1. (Optional) Use an existing API key instead of auto-provisioning

Skip this whole section if you're happy with auto-provisioning.

Otherwise, get a key one of these ways:

Manual provision via API:

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

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

Then set GILDARA_API_KEY in your MCP config (see examples below).

2. Add to Claude Desktop

Edit your claude_desktop_config.json. No env block needed for auto-provision:

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

Or, with an existing key:

{
  "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 using the same configuration as Claude Desktop (with or without the env block — same rules apply).

4. Add to Claude Code

Run:

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

Auto-provision works here too. Set GILDARA_API_KEY in your environment only if you want to use an existing key.

5. Add to Claude Chat (claude.ai)

Gildara supports Remote MCP via HTTP/SSE.

• Go to Settings > Connectors in Claude Chat.
• Select "Add custom connector".
• Name: Gildara Vault.
• Remote MCP server URL: https://gildara.io/api/mcp/mcp.
• Authentication: OAuth 2.1 (you will be redirected to the Gildara consent page to authorize).

Tools

Tool	Description
search_prompts	Semantic search over your vault using Gemini embeddings
list_prompts	List all prompts in your vault
get_prompt	Get prompt details and operating contract config
resolve_prompt	Get compiled system prompt with variable substitution
run_prompt	Run prompt through AI with auto-repair
create_prompt	Create a new prompt
append_memory	Add info to an existing memory-type prompt
list_blueprints	Browse 48+ agent blueprint templates

Example usage

Once connected, just tell your AI:

• "Search my vault for prompts related to security audits."
• "Resolve my code-review-agent prompt with the code_diff variable."
• "Run the security-audit prompt against this code."
• "Append this preference to my 'Personal Context' memory: I prefer TypeScript over JavaScript."

Local-First Support

Gildara features a local-first architecture. The MCP server automatically caches resolved prompts to ~/.gildara/cache/ to ensure your agents remain functional even if the Gildara API is temporarily unreachable.

Environment variables

Variable	Required	Description
GILDARA_API_KEY	No	Your API key (pvk_...). If unset, the server auto-provisions a new agent account on first run and caches the key at ~/.gildara/auto-key.json. Set this explicitly to use an existing key.
GILDARA_BASE_URL	No	Override API URL (default: https://gildara.io).

License

MIT