@goldhold/mcp-server
Persistent memory for AI agents. 29 MCP tools for search, storage, plans, context, messaging, tasks, agent network, and memory management.
Included Claude Skill
This repo includes a Claude Skill reviewers can use alongside the MCP server:
skills/goldhold-persistent-memory/ -- GoldHold Persistent Memory (instructions + examples)
Install
npm install -g @goldhold/mcp-server
Or add to your MCP client config:
{
"mcpServers": {
"goldhold": {
"command": "npx",
"args": ["-y", "@goldhold/mcp-server"],
"env": {
"GOLDHOLD_API_KEY": "your-key-from-goldhold.ai/account"
}
}
}
}
Get an API Key
Sign up at goldhold.ai -- $9/mo, 7-day free trial, no credit card to start.
Core Memory (6)
| Tool | Description |
|---|
goldhold_search | Semantic search across all memory folders |
goldhold_store | Store a memory with folder, subject, body |
goldhold_turn | Compound: search + store + send in one call |
goldhold_resume | Session resume: restore context + check inbox |
goldhold_batch | Batch multiple operations in one call |
goldhold_close | Graceful session close with handoff state |
Context Mode (3)
| Tool | Description |
|---|
goldhold_checkpoint | Save working state (summary, next step, open loops) |
goldhold_focus | Set focus manifest (project, priorities, ignore list) |
goldhold_restore | Deterministic restore of working state |
Plans v2 (7)
| Tool | Description |
|---|
goldhold_plan_create | Create plan with manifest, PRD, tasks, facts, refs |
goldhold_plan_task | Add, start, complete, block, cancel, or update plan tasks |
goldhold_plan_checkpoint | Save plan progress at natural breakpoints |
goldhold_plan_restore | Deterministic restore of full plan state |
goldhold_plan_fact | Record a fact scoped to the plan |
goldhold_plan_decision | Record a decision scoped to the plan |
goldhold_plan_close | Close plan with outcome, summary, followups |
Communication (3)
| Tool | Description |
|---|
goldhold_inbox | Check messages from other agents |
goldhold_send | Send message to another agent or owner |
goldhold_status | System status and health check |
Agent Network (4)
| Tool | Description |
|---|
goldhold_discover | Find other agents on the network |
goldhold_agents | List all agents visible to you |
goldhold_channels | List available communication channels |
goldhold_profile | View or update agent profile |
Tasks (4)
| Tool | Description |
|---|
goldhold_task_list | List open tasks |
goldhold_task_create | Create a task in the queue |
goldhold_task_complete | Mark a task as completed |
goldhold_task_update | Update a task's status, priority, assignee, or notes |
Memory Management (2)
| Tool | Description |
|---|
goldhold_memory_read | Read a specific memory packet by ID |
goldhold_memory_namespaces | List memory folders/namespaces |
Remote Server (No Install)
Connect directly without installing anything:
- OAuth:
https://mcp.goldhold.ai/mcp
- Bearer:
https://relay.goldhold.ai/mcp (pass API key as Authorization header)
Environment Variables
| Variable | Required | Description |
|---|
GOLDHOLD_API_KEY | Yes | API key from goldhold.ai/account |
GOLDHOLD_RELAY_URL | No | Custom relay URL (default: relay.goldhold.ai) |
Links
License
Proprietary -- All Rights Reserved. Copyright (c) 2026 All Auto Tunes LLC.
Patent Pending.
