# Gildara Io Mcp Server

> Connect AI tools to your Gildara prompt vault with operating contracts and auto-repair.

- **Type:** MCP server
- **Install:** `agentstack add mcp-gildara-io-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gildara-io](https://agentstack.voostack.com/s/gildara-io)
- **Installs:** 0
- **Category:** [Security](https://agentstack.voostack.com/c/security)
- **Latest version:** 0.1.1
- **License:** MIT
- **Upstream author:** [gildara-io](https://github.com/gildara-io)
- **Source:** https://github.com/gildara-io/mcp-server
- **Website:** https://gildara.io

## Install

```sh
agentstack add mcp-gildara-io-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

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

```json
{ "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](https://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](https://gildara.io) 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:**

```bash
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](https://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:**

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

Or, with an existing key:

```json
{
  "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:

```bash
/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 |

## 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`](../docs/MCP_INTEGRATION_CONTRACT.md) and run `npm run test:unit` from the monorepo root to verify parity.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [gildara-io](https://github.com/gildara-io)
- **Source:** [gildara-io/mcp-server](https://github.com/gildara-io/mcp-server)
- **License:** MIT
- **Homepage:** https://gildara.io

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **0.1.1** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-gildara-io-mcp-server
- Seller: https://agentstack.voostack.com/s/gildara-io
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.