Package Exports

@goldhold/mcp-server
@goldhold/mcp-server/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@goldhold/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@goldhold/mcp-server

Persistent memory for AI agents. 29 MCP tools for search, storage, plans, context, messaging, tasks, networking, and self-update.

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, or cancel 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_connect`	Connect to another agent
`goldhold_disconnect`	Disconnect from an agent
`goldhold_profile`	View or update agent profile

Tasks (2)

Tool	Description
`goldhold_task_create`	Create a task in the queue
`goldhold_task_list`	List open tasks

Self-Update (3)

Tool	Description
`goldhold_check_update`	Check for available updates
`goldhold_update`	Apply update
`goldhold_rollback`	Roll back to previous version

System (1)

Tool	Description
`goldhold_status`	Health and version info

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)

JSPM