@packregister/mcp-server

MCP server exposing one Packregister workspace's sync API as agent tools: find or create items, read an item type's fillable attribute schema, update attribute values safely (merges instead of overwriting), create a new attribute (with a required human confirmation step), and attach a file.

Setup

1. In Packregister, go to Workspace settings → Agents and click Create agent connection. Download the packregister-agent.env file it offers — it contains PACKREGISTER_API_URL and PACKREGISTER_API_KEY for your workspace. Keep it secret; it grants write access.
2. Add this to your MCP client's config, pointing envFile (or your client's equivalent) at the downloaded file:

{
  "mcpServers": {
    "packregister": {
      "command": "npx",
      "args": ["-y", "@packregister/mcp-server"],
      "envFile": "/path/to/packregister-agent.env",
    },
  },
}

If your client has no envFile support, source it into the environment yourself before launching the client: set -a && source packregister-agent.env && set +a.

Tools

• find_item — point lookup by name or article number.
• list_item_types, get_item_type_schema — schema discovery.
• get_item_values — an existing item's current attribute values.
• create_item — create a new item; always lands as draft.
• update_item_attributes — set values on an existing item; merges with current values instead of replacing them; always lands as draft.
• create_attribute — propose a new attribute; requires the connected client to confirm with a human before anything is written.
• upload_file — upload a file, get back the value to use for a file-type attribute.

Development

npm install
npm test
npm run build