Mcp Server

Gildara MCP

One prompt vault. Every agent. Zero setup. Give Claude, Cursor, Windsurf, and Claude Code a shared, searchable prompt library that survives across chats, machines, and tools.

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

Paste into claude_desktop_config.json, restart Claude — your Gildara tools appear in Claude's tool list. No signup. No API key. The server auto-provisions a free agent on first run and prints a one-click link code to pair it with your account later.

→ Get started at gildara.io — pair your auto-provisioned agent to sync your vault and unlock Pro.

---

What your AI can do

• Search prompts semantically — find by meaning, not just keywords (Gemini embeddings).
• Resolve + run prompts — compiled system prompts with operating-contract sections assembled, auto-repair on JSON schema failures.
• Create + append — save new prompts, or append persistent facts to memory-type prompts.
• Dispatch briefs to agents — say "send this to gevorg" and the MCP server creates a Brief, ships it as a .md attachment to your paired Telegram chat, and @mentions the target agent's bot. One call closes the sketch-in-chat → agent-on-another-box → result-in-chat loop. See docs/briefs/dogfood-rollout-v0.md for the agent-side integration recipe.
• Browse 48+ blueprints — 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

One click:

Or manually: 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 this in your terminal:

claude 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.

1. Go to Settings > Connectors in Claude Chat.
2. Select "Add custom connector".
3. Name: Gildara Vault.
4. Remote MCP server URL: https://gildara.io/api/mcp/mcp.
5. 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
save_brief	Dispatch a brief to a named agent (MD attachment via Telegram, @mention routes to the right bot)
list_blueprints	Browse 48+ agent blueprint templates
get_account_link	Get the URL to link this agent's vault to a human Gildara account

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."
• "Send this to gevorg: analyze last week's Meta Ads performance and flag the bottom 3 campaigns."

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

---

Contributing / Maintainers

This package is the stdio MCP server. A sibling HTTP server lives at app/api/mcp/[transport]/route.ts in the parent monorepo (powers the Claude.ai native connector). Both must stay at parity — tool names, argument schemas, response text.

Before adding, removing, or changing a tool here, read docs/MCP_INTEGRATION_CONTRACT.md and run npm run test:unit from the monorepo root to verify parity.