{"_id":"@achromat-ai/mcp-server","_rev":"6-5e352ee9ea203d64365bb14075ea82bd","name":"@achromat-ai/mcp-server","dist-tags":{"latest":"0.1.4"},"versions":{"0.0.0-stage":{"name":"@achromat-ai/mcp-server","version":"0.0.0-stage","_id":"@achromat-ai/mcp-server@0.0.0-stage","stub":true,"maintainers":[{"name":"tr1ple6","email":"damian_smith442@aol.com"}],"dist":{"shasum":"9a69c45cca4dea905d640ca34b3ff7feec0f4bf1","tarball":"https://registry.npmjs.org/@achromat-ai/mcp-server/-/mcp-server-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-2IHjja1WZgW1PLkpgnE/XC8s/1JjeVOkcp2MOorLqoy9TtxvXeCqMWHkBijS85XY9axkUNGIVopgOVh6qbfgyg==","signatures":[{"sig":"MEUCIQCkXhS3S3zOihDu10ATfGjxZHSLB3A62n4PwAmxqaqEDQIgLRsF+8UJEalqGn8FQllUzqbUG6MgaoOD6/DyZ46zndQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":345},"_npmUser":{"name":"tr1ple6","email":"damian_smith442@aol.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@achromat-ai/mcp-server","version":"0.1.0","keywords":["mcp","model-context-protocol","agents","achromat","policy","compliance"],"license":"MIT","_id":"@achromat-ai/mcp-server@0.1.0","maintainers":[{"name":"tr1ple6","email":"damian_smith442@aol.com"}],"homepage":"https://github.com/achromat-ai/achromat-mcp-server#readme","bugs":{"url":"https://github.com/achromat-ai/achromat-mcp-server/issues"},"bin":{"achromat-mcp":"dist/index.js"},"dist":{"shasum":"0278b46c4e7a9524a02cf014b92f4c3e040e9a71","tarball":"https://registry.npmjs.org/@achromat-ai/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":11,"integrity":"sha512-QSLxoZb196AYqoJP5IKF7OSUgUU+0b2+B9K/vxTZ0ZTFAdwvG2Scd5OSpbDLte2dWiCnIWyATXcNYIMm+b9Ovw==","signatures":[{"sig":"MEUCIQDAhaQhQtjjD2BoYzb+/NEgRbCvvakshtF0ulaelwt5eQIge5zbLxTbJZ0/KEZ/IwBrDyGp7Dfr2aJpt0adtijiJKk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIEQZKXCIEuPf0hhpSTnO47NrnCw4AxH2Oi26fThR0sErAiA6Tbef7PYLfzE/27LQnWRsqUHKRUecKmWooY/V0YsHlA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":73254},"type":"module","engines":{"node":">=20"},"gitHead":"e55b7544331923b9c07ff75f0f5614716d7aeac8","scripts":{"test":"vitest run","build":"tsc && node -e \"require('node:fs').chmodSync('dist/index.js', 0o755)\"","start":"node dist/index.js","inspect":"npm run build && npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","prepublishOnly":"npm run typecheck && npm test && npm run build"},"_npmUser":{"name":"tr1ple6","email":"damian_smith442@aol.com"},"repository":{"url":"git+https://github.com/achromat-ai/achromat-mcp-server.git","type":"git"},"_npmVersion":"11.6.1","description":"MCP server that lets an agent recall and calibrate tool calls against Achromat MOM (mom.achromat.ai), from any MCP host.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"4.6.5","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.11","typescript":"7.0.2","@types/node":"22.20.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1792079810200_0.4829989695598853","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@achromat-ai/mcp-server","version":"0.1.1","keywords":["mcp","model-context-protocol","agents","achromat","policy","compliance"],"license":"MIT","_id":"@achromat-ai/mcp-server@0.1.1","maintainers":[{"name":"tr1ple6","email":"damian_smith442@aol.com"}],"homepage":"https://github.com/achromat-ai/achromat-mcp-server#readme","bugs":{"url":"https://github.com/achromat-ai/achromat-mcp-server/issues"},"bin":{"achromat-mcp":"dist/index.js"},"dist":{"shasum":"1d993cb073fff08b7a843717babb09cd0a84fdaa","tarball":"https://registry.npmjs.org/@achromat-ai/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":11,"integrity":"sha512-uT8ef87kwII5s+eWksWQaLqat5RvH87QejPTr6Hm1sdq+FI9swDKfvH53WT/8Ly1xRcOUhhcS0EYJmjtP50AUg==","signatures":[{"sig":"MEQCID09pgnAVY5FoYCt5iP+vnuSM7AnPuKlLiNUunrPkBLhAiBEPaURdM3SMIaX7tq3s5yu4pZCQ4aydpBqWf/2eBGNfQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDf5t5t7mOF2COR/xXU+Vuw0lNwxQU1a+UHy8cE+9LcaQIhANSPXXPpnKwd6tAQTVIMzJZSVqFFZ1PxE0jBrsvtuT7l","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":73293},"type":"module","engines":{"node":">=20"},"gitHead":"704bd03637f00858592bb01de2da9caa8ffdaf79","mcpName":"ai.achromat/mcp-server","scripts":{"test":"vitest run","build":"tsc && node -e \"require('node:fs').chmodSync('dist/index.js', 0o755)\"","start":"node dist/index.js","inspect":"npm run build && npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","prepublishOnly":"npm run typecheck && npm test && npm run build"},"_npmUser":{"name":"tr1ple6","email":"damian_smith442@aol.com"},"repository":{"url":"git+https://github.com/achromat-ai/achromat-mcp-server.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server that lets an agent recall and calibrate tool calls against Achromat MOM (mom.achromat.ai), from any MCP host.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"4.6.5","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.11","typescript":"7.0.2","@types/node":"22.20.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1792426921701_0.347737772178508","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@achromat-ai/mcp-server","version":"0.1.2","keywords":["mcp","model-context-protocol","agents","achromat","policy","compliance"],"license":"MIT","_id":"@achromat-ai/mcp-server@0.1.2","maintainers":[{"name":"tr1ple6","email":"damian_smith442@aol.com"}],"homepage":"https://github.com/achromat-ai/achromat-mcp-server#readme","bugs":{"url":"https://github.com/achromat-ai/achromat-mcp-server/issues"},"bin":{"achromat-mcp":"dist/index.js"},"dist":{"shasum":"69c92baed97763a6c866c876fb742b6cf394d573","tarball":"https://registry.npmjs.org/@achromat-ai/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":11,"integrity":"sha512-5dnXNbf2VaCpiQ2GNE+q5gSUN2+L03uqOS+baNXrdjPHPsvZ1G93FVqcMs8RveglPA1ap/pYdu6kiHnvfrWr0A==","signatures":[{"sig":"MEUCIEDLkNJN76CKSAOvJNgpTvNYIcDKFgu5qQfPLnYLuOY4AiEAoePcHwfjUkWJxxjHsry6zTesAc/c1MwO0Nwyi26bGnI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIAik3kiY/Mrx2T0cReF13A+HqM+cQMPjMc9DkqzIRBIHAiEA4RDzJJ7ia9IkbjCXytOAcn2SO8/t/HeU5SRen0XnoCc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":73293},"type":"module","engines":{"node":">=20"},"gitHead":"2044516131b8120fe7c0ce188f412c236c343f69","mcpName":"ai.achromat/mcp-server","scripts":{"test":"vitest run","build":"tsc && node -e \"require('node:fs').chmodSync('dist/index.js', 0o755)\"","start":"node dist/index.js","inspect":"npm run build && npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","prepublishOnly":"npm run typecheck && npm test && npm run build"},"_npmUser":{"name":"tr1ple6","email":"damian_smith442@aol.com"},"repository":{"url":"git+https://github.com/achromat-ai/achromat-mcp-server.git","type":"git"},"_npmVersion":"11.6.1","description":"MCP server that lets an agent recall and calibrate tool calls against Achromat MOM (mom.achromat.ai), from any MCP host.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"4.6.5","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.11","typescript":"7.0.2","@types/node":"22.20.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.2_1792655980544_0.9575100229451696","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@achromat-ai/mcp-server","version":"0.1.3","keywords":["mcp","model-context-protocol","agents","achromat","policy","compliance"],"license":"MIT","_id":"@achromat-ai/mcp-server@0.1.3","maintainers":[{"name":"tr1ple6","email":"damian_smith442@aol.com"}],"homepage":"https://github.com/achromat-ai/achromat-mcp-server#readme","bugs":{"url":"https://github.com/achromat-ai/achromat-mcp-server/issues"},"bin":{"achromat-mcp":"dist/index.js"},"dist":{"shasum":"9b024822a131ebce9175c5152d28b2be1aebae72","tarball":"https://registry.npmjs.org/@achromat-ai/mcp-server/-/mcp-server-0.1.3.tgz","fileCount":11,"integrity":"sha512-gu4inYDJ5u7hdG8Rgydki8FZ2YMJF72OUZ39nUZAUvBh9u3UmMACM/Xs7uo80+juNBgpNoYjx+Msp8W9Zm/Diw==","signatures":[{"sig":"MEUCIEC9qcZ2RTncdUrssx03lywJWNSpQbtryytuQYacIN0SAiEA0oNQGAAB3QpVsAr8mdj2OaBcZBS7Fq1XOrxe1BfDVP0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDx1M54Tm2+ZFSL7oy+CbYjsyFuokZGlnW67EEu+nBMLgIhALM7ZjvACabTlUEqnAVuBJKD+lnT0okbMoMkAOmyFjKh","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":77151},"type":"module","engines":{"node":">=20"},"gitHead":"c7d821546521bd5035d561e1b4a04dbf634b98e5","mcpName":"ai.achromat/mcp-server","scripts":{"test":"vitest run","build":"tsc && node -e \"require('node:fs').chmodSync('dist/index.js', 0o755)\"","start":"node dist/index.js","inspect":"npm run build && npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","prepublishOnly":"npm run typecheck && npm test && npm run build"},"_npmUser":{"name":"tr1ple6","email":"damian_smith442@aol.com"},"repository":{"url":"git+https://github.com/achromat-ai/achromat-mcp-server.git","type":"git"},"_npmVersion":"11.6.1","description":"MCP server that lets an agent recall and calibrate tool calls against Achromat MOM (mom.achromat.ai), from any MCP host.","directories":{},"_nodeVersion":"22.12.0","dependencies":{"zod":"4.6.5","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.11","typescript":"7.0.2","@types/node":"22.20.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.3_1793363625049_0.9852901509950587","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"_id":"@achromat-ai/mcp-server@0.1.4","bin":{"achromat-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/achromat-ai/achromat-mcp-server/issues"},"dist":{"shasum":"2621c48d21bc960df28d6882dd21882ed41f960a","tarball":"https://registry.npmjs.org/@achromat-ai/mcp-server/-/mcp-server-0.1.4.tgz","fileCount":11,"integrity":"sha512-BN6J5HjUif9Nxzl4boMCywTR4MO93NGiWkqn5IIzoog+F+tGkm0sAkAW3JZ1n0J+zAodYTKGs2kpJd5ZYKlTxA==","signatures":[{"sig":"MEUCIBNd19jy1WB0KwrAtmlWJKSWL/R8NSMzajeJsqjamR8eAiEAqvvMCVp7DY/2UysXdWM4ulEaWApdZSiXHzZTPyXOXts=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCccEMU2qRBF3eqMFF2jK5VbI+NHVD2k/UOv0FwC1+EMQIgeM9UiGpiuQOCN+yUxhFiNl/sPzkRTrI7QquMLQQ2Jkw="}],"unpackedSize":77217},"name":"@achromat-ai/mcp-server","type":"module","engines":{"node":">=20"},"gitHead":"d167c6efa6e3e157f0360c8c730b4c5a53d23095","license":"MIT","mcpName":"ai.achromat/mcp-server","scripts":{"test":"vitest run","build":"tsc && node -e \"require('node:fs').chmodSync('dist/index.js', 0o755)\"","start":"node dist/index.js","inspect":"npm run build && npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.test.json","prepublishOnly":"npm run typecheck && npm test && npm run build"},"version":"0.1.4","_npmUser":{"name":"tr1ple6","email":"damian_smith442@aol.com"},"homepage":"https://github.com/achromat-ai/achromat-mcp-server#readme","keywords":["mcp","model-context-protocol","agents","achromat","policy","compliance"],"repository":{"url":"git+https://github.com/achromat-ai/achromat-mcp-server.git","type":"git"},"_npmVersion":"11.6.1","description":"MCP server that lets an agent recall and calibrate tool calls against Achromat Machine Operational Memory (achromat.ai), from any MCP host.","directories":{},"maintainers":[{"name":"tr1ple6","email":"damian_smith442@aol.com"}],"_nodeVersion":"22.12.0","dependencies":{"zod":"4.6.5","@modelcontextprotocol/sdk":"1.32.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"4.1.11","typescript":"7.0.2","@types/node":"22.20.5"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.4_1793817748896_0.8014118206642564"}}},"time":{"created":"2026-10-15T15:55:52.721Z","modified":"2026-11-04T18:42:29.227Z","0.0.0-stage":"2026-10-15T15:55:52.721Z","0.1.0":"2026-10-15T15:56:50.302Z","0.1.1":"2026-10-19T16:22:01.792Z","0.1.2":"2026-10-22T07:59:40.634Z","0.1.3":"2026-10-30T12:33:45.129Z","0.1.4":"2026-11-04T18:42:29.031Z"},"bugs":{"url":"https://github.com/achromat-ai/achromat-mcp-server/issues"},"license":"MIT","homepage":"https://github.com/achromat-ai/achromat-mcp-server#readme","keywords":["mcp","model-context-protocol","agents","achromat","policy","compliance"],"repository":{"url":"git+https://github.com/achromat-ai/achromat-mcp-server.git","type":"git"},"description":"MCP server that lets an agent recall and calibrate tool calls against Achromat Machine Operational Memory (achromat.ai), from any MCP host.","maintainers":[{"name":"tr1ple6","email":"damian_smith442@aol.com"}],"readme":"# Achromat MCP server\n\nAn [MCP](https://modelcontextprotocol.io) server that lets any MCP host (Claude Desktop, an IDE, an agent framework) use [Achromat Machine Operational Memory (MOM)](https://achromat.ai) as native tools. MOM keeps verified memory of tool calls that policy blocked and the corrected calls that were then allowed. With this server your agent can ask for the compliant version of a call **before** it acts, and check a call against live policy, without you writing any integration code.\n\nThe server runs on your machine as a child process of the host and talks to it over stdio. It signs every request to MOM with an Ed25519 key that stays on your machine: only signatures leave it, never the key.\n\n## Add it to Claude Desktop\n\nOpen the configuration file:\n\n| OS | Path |\n| --- | --- |\n| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |\n| Windows | `%APPDATA%\\Claude\\claude_desktop_config.json` |\n\nAdd the server under `mcpServers`, then restart Claude Desktop:\n\n```json\n{\n  \"mcpServers\": {\n    \"achromat\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@achromat-ai/mcp-server\"]\n    }\n  }\n}\n```\n\nThat is the whole setup. Requires Node.js 20 or newer; `-y` lets `npx` install the package without asking. Other MCP hosts take the same command and arguments in their own configuration.\n\n## First use: your agent sets up the identity\n\nEvery request to MOM is signed, so the server needs a key that MOM knows. You do not create or register one yourself. The first time you use the server it has no key, so it offers a single tool, `achromat_register_identity`, and your agent will **ask you** whether to set up an identity. If you say yes, the server:\n\n1. generates an Ed25519 key pair on your machine,\n2. does a short proof of work (about a second; it is how MOM limits automated sign-ups),\n3. registers the **public** key with MOM, and\n4. saves the **private** key to `~/.achromat/achromat_agent_key.pem`, readable only by you.\n\nThen `achromat_recall` and `achromat_calibrate` appear in place of the registration tool. If your host does not refresh its tool list by itself, restart it once.\n\nWhat leaves your machine: the public key, the proof of work, and a signature proving you hold the private key. The private key never does. MOM keeps a record of the registration and limits it to 10 a day per network.\n\n**The key file is the identity.** Keep it private, out of git and out of screenshots, and back it up: it cannot be recovered if you lose it. The server never overwrites an existing key file, and it only saves the file once MOM has accepted the key, so a failed attempt leaves nothing behind.\n\n## Choosing where the key lives\n\nBy default the key is at `~/.achromat/achromat_agent_key.pem`. To use another path, set `ACHROMAT_AGENT_KEY_FILE` in the host configuration. This works for a new key (the server creates it there) and for one you already have:\n\n```json\n{\n  \"mcpServers\": {\n    \"achromat\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@achromat-ai/mcp-server\"],\n      \"env\": {\n        \"ACHROMAT_AGENT_KEY_FILE\": \"/Users/you/keys/achromat_agent_key.pem\"\n      }\n    }\n  }\n}\n```\n\nOn Windows use the full path with escaped backslashes, for example `\"C:\\\\Users\\\\you\\\\keys\\\\achromat_agent_key.pem\"`. A leading `~` is expanded by the server. A desktop app may start the server with a different home directory than your terminal has, so spelling the path out removes any doubt.\n\nAn existing key must be an unencrypted PKCS#8 Ed25519 PEM file that MOM already knows.\n\n## Attributing an install to a link (optional)\n\nIf you share a link or a setup snippet and want to know which one brought an install, add an `ACHROMAT_REF` tag to the host configuration. It is a short label of 1 to 32 characters from `a-z`, `0-9`, `_` and `-`, for example `launch-post`:\n\n```json\n{\n  \"mcpServers\": {\n    \"achromat\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@achromat-ai/mcp-server\"],\n      \"env\": { \"ACHROMAT_REF\": \"launch-post\" }\n    }\n  }\n}\n```\n\nThe tag is sent only while the server registers its identity, as `?ref=launch-post` on the two registration calls, and nowhere else. It is the label itself and nothing about you or your machine. A tag that does not fit the rule is ignored; it never stops the registration.\n\n## Run from source\n\n```bash\ngit clone https://github.com/achromat-ai/achromat-mcp-server.git\ncd achromat-mcp-server\nnpm install\nnpm run build\n```\n\nPoint the host at the build instead of `npx`:\n\n```json\n{\n  \"mcpServers\": {\n    \"achromat\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/achromat-mcp-server/dist/index.js\"]\n    }\n  }\n}\n```\n\nTo try the tools in a browser without a host, use the MCP Inspector:\n\n```bash\nnpm run inspect\n```\n\n## Tools\n\n### `achromat_register_identity`\n\nOffered only while there is no key file. Creates and registers an identity as described above. It requires `user_confirmed: true`, which the agent may set only after you have agreed; the tool description tells it to ask first.\n\n| Parameter | Required | Description |\n| --- | --- | --- |\n| `user_confirmed` | yes | Must be `true`, and only after the user has said yes. |\n\n### `achromat_recall`\n\nCall this **before** running a tool that policy might block (payments, credit decisions, robot or plant commands, shell, SQL, web requests). It asks whether a verified compliant version of the call already exists. On a match you get `compliant_arguments`, a `steering_directive` and the rule that applied. Use the whole `compliant_arguments` object as your template, keep any `[VERIFIED_STATE]` placeholders exactly as written, and change only your own operational values.\n\nWhen the lesson is an approved one, the answer ends with a **citation line**: `Tool arguments follow a verified Achromat MOM lesson: https://achromat.ai/?ref=audit#lesson-<id>`. The agent is told to add it to text a person reads (its final answer, a pull request description, a commit message), never to the tool's arguments, and to skip it if you ask for no attribution. The link opens that lesson on the Achromat site. A lesson that is only your own, not yet shared, gets no citation.\n\n| Parameter | Required | Description |\n| --- | --- | --- |\n| `domain` | yes | `fintech`, `industrial_iot`, `robotics` or `devsecops`. |\n| `tool_name` | yes | The exact name of the tool you are about to call. |\n| `task_description` | yes | What you are trying to do, in plain words (16 to 1000 characters, at least 3 words). No amounts, identifiers or personal data. |\n| `arguments` | **yes** | The arguments you intend to send, as a non-empty JSON object using the tool's real key names. **Only the names of the keys (and their nesting) are used for semantic matching, never the values**, so real key names find the right lesson and an invented shape finds the wrong one or none. |\n\n### `achromat_calibrate`\n\nCall this when recall found nothing, or when the stakes are high. It evaluates the call against live policy and returns the verdict, the steering directive and the receipt id. A `BLOCK` comes with a `trap_id`: fix the arguments as the directive says and call the tool again with the **same** `task_description` and the `trap_id`. An `ALLOW` means the call complies. A block followed by an allow becomes a lesson for other agents.\n\n| Parameter | Required | Description |\n| --- | --- | --- |\n| `domain` | yes | As above. |\n| `tool_name` | yes | As above. |\n| `task_description` | yes | Use exactly the same wording on the retry: it is what pairs a block with its fix. |\n| `arguments` | yes | The arguments of the call to check. A non-empty JSON object. |\n| `trap_id` | no | Only on a retry: the `trap_id` from the earlier `BLOCK`. |\n\nNever put secrets or credentials in `arguments` or `task_description`; the service rejects them.\n\nThe tools use the name `tool_name`; the service's own field is `tool`, and the server maps between them.\n\nLesson text (rules, directives, arguments) comes from the community. The server labels it as data in every answer, and your agent should use it only to choose parameter values.\n\n## Configuration\n\n| Variable | Default | Meaning |\n| --- | --- | --- |\n| `ACHROMAT_AGENT_KEY_FILE` | `~/.achromat/achromat_agent_key.pem` | Where the agent's Ed25519 private key is, or will be created. |\n| `ACHROMAT_BASE_URL` | `https://achromat.ai` | The service origin. Must be `https` (plain `http` only for `localhost`). |\n| `ACHROMAT_REF` | none | Optional attribution tag (see above), sent only while registering. An invalid tag is ignored. |\n\nWhether the key file exists decides which tools are offered, and it is checked at startup and right after a registration. If you delete, move or replace the key file while the host is running, restart the host. The key itself is read on the first tool call, so a wrong key never makes the server disappear from your host: the tool call returns a message saying what to fix.\n\n## When something goes wrong\n\nEvery failure comes back to the agent as a readable tool result, with the next step.\n\n| What you see | Cause and fix |\n| --- | --- |\n| Only `achromat_register_identity` is listed | There is no key file yet. That is the normal first state. Say yes when your agent asks. |\n| `A key file already exists at …` | An identity is already set up there. To start over, move or delete the file and restart the host. |\n| `The key could not be saved at …` | The folder is not writable. Fix its permissions or set `ACHROMAT_AGENT_KEY_FILE`. Nothing was registered. |\n| `Too many registration requests` / `registration limit` | MOM limits sign-ups per network (10 a day). Wait, or try from another network. Nothing was created. |\n| `Could not reach …` / `No answer from …` | A network problem. Nothing was created; try again. |\n| `The identity was registered, but the key file could not be moved …` | Rare. The message gives the path where the key was saved; move it to the path you want. Do not delete it. |\n| `The key file is passphrase-protected` / `…holds a rsa key` | An existing key must be unencrypted PKCS#8 Ed25519. |\n| `The key file … is accessible to other users` (in the host's server log) | Run `chmod 600` on the key file. It still works until you do. |\n| `AGENT_KEY_UNKNOWN` (401) | A key file exists but MOM does not know it. Move or delete the file and restart the host to create a new identity. |\n| `AGENT_KEY_INACTIVE` (403) | The key was revoked or rotated. Move or delete the file and restart the host. |\n| `AGENT_SIGNATURE_EXPIRED` (401) | Your clock is more than 60 seconds off. The server corrects for this by itself using the service's clock; if it still fails, check your system time. |\n| `Rate limited` (429) | Recall allows 240 an hour per key and 50 distinct lessons a day; calibrate allows 120 an hour. Wait for the time given. |\n| `HTTP 400 INVALID_REQUEST` | The service lists the offending fields. Often a credential or personal data in the text or arguments. |\n\nServer logs go to stderr, which hosts write to their own MCP log files (Claude Desktop keeps them in its logs folder; on macOS that is under `~/Library/Logs/Claude/`). The server never logs keys, signatures or request contents.\n\nIf the host cannot start `npx`, it may not see the `PATH` your terminal does (common with `nvm`). Put the absolute path of `npx` or `node` in `command`.\n\n## Development\n\n```bash\nnpm run typecheck   # source and tests\nnpm test            # vitest\nnpm run build       # compile to dist/ and mark dist/index.js executable\nnpm start           # run the built server on stdio (waits for a host)\n```\n\nstdout is the protocol channel, so the server writes nothing else to it.\n\nThe signing and registration code follows the byte-level contract in the [agent protocol](https://achromat.ai/skill.md) (sections 2 and 3), and the tests reproduce its published self-check vectors exactly: the request signature, and the proof-of-work nonce. Ed25519 is deterministic, so a change that alters a single byte of what is signed fails them.\n\nThe proof of work searches on several worker threads (up to 8, never all cores) so that it takes about a second and the server stays responsive while it runs.\n\n## Licence\n\n[MIT](LICENSE)\n","readmeFilename":"README.md"}