What is io.github.jerrysrodz/goldhold?

Persistent memory for AI agents. Search, store, and recall across sessions.

How do I install io.github.jerrysrodz/goldhold?

Clone io.github.jerrysrodz/goldhold from https://github.com/jerrysrodz/goldhold-mcp-server and configure it as an MCP server in your client (Claude Desktop, Cursor, or VS Code).

What category does io.github.jerrysrodz/goldhold belong to?

io.github.jerrysrodz/goldhold is listed under Developer Tools MCP servers on MCPFind.

io.github.jerrysrodz/goldhold — MCP Server for Developer Tools

@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

All 29 Tools

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)

License

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

{
  "mcpServers": {
    "io-github-jerrysrodz-goldhold": {
      "command": "npx",
      "args": [
        "-y",
        "@goldhold/mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.jerrysrodz/goldhold works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.jerrysrodz/goldhold