{"_id":"@blipr/mcp","_rev":"5-c73317ba57b087c723dbbf32f7172d01","name":"@blipr/mcp","dist-tags":{"latest":"0.6.0"},"versions":{"0.3.1":{"name":"@blipr/mcp","version":"0.3.1","keywords":["mcp","modelcontextprotocol","blipr","notifications","push","alerts","apns","ai-agents","claude"],"author":{"name":"Applogico LLC"},"license":"MIT","_id":"@blipr/mcp@0.3.1","maintainers":[{"name":"cleverjam","email":"lizjaime@gmail.com"}],"homepage":"https://blipr.dev","bugs":{"url":"https://github.com/applogico/blipr-mcp/issues"},"bin":{"blipr-mcp":"dist/index.js"},"dist":{"shasum":"da02d33891dfed75d4f0f3a1b75b77f71677bdd2","tarball":"https://registry.npmjs.org/@blipr/mcp/-/mcp-0.3.1.tgz","fileCount":7,"integrity":"sha512-W5zspNyVJpH3avo+9PCo2sbHiEcoIJIyhNfhcQYZpQ2dALzVhWMzjckZBCB7/a0jvTbuHIBO4skZicCKmrC1Hw==","signatures":[{"sig":"MEQCIA2BfGNWxYu9/5D8sAGdVGjVmgknrjzzSmgyA76f1qlRAiAWVYCVehCa1PCxT3bBMDybg5Hc3MIH5FFyn9JSqvQLTQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33152},"type":"module","engines":{"node":">=18"},"gitHead":"a1d23d4471259ed61e021278f06483ba8acee411","scripts":{"test":"vitest run","build":"tsc","start":"node dist/index.js","prepare":"npm run build","test:watch":"vitest"},"_npmUser":{"name":"cleverjam","email":"lizjaime@gmail.com"},"repository":{"url":"git+https://github.com/applogico/blipr-mcp.git","type":"git"},"_npmVersion":"10.9.3","description":"MCP server that lets AI agents send Blipr push alerts to your phone — your agent can page you.","directories":{},"_nodeVersion":"22.20.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.3.1_1785377921801_0.1766684932071172","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@blipr/mcp","version":"0.4.0","keywords":["mcp","modelcontextprotocol","blipr","notifications","push","alerts","apns","ai-agents","claude"],"author":{"name":"Applogico LLC"},"license":"MIT","_id":"@blipr/mcp@0.4.0","maintainers":[{"name":"cleverjam","email":"lizjaime@gmail.com"}],"homepage":"https://blipr.dev","bugs":{"url":"https://github.com/applogico/blipr-mcp/issues"},"bin":{"blipr-mcp":"dist/index.js"},"dist":{"shasum":"93bfb188e9a37084eb213c9fb3be2c79668156ab","tarball":"https://registry.npmjs.org/@blipr/mcp/-/mcp-0.4.0.tgz","fileCount":7,"integrity":"sha512-fCCiIYoycYR3Rn+p890TUQR7Us6z7qtlibR7SDXZtiwSzIr+tloXbz0vm+GsNUBpk8GU6qPiUUhNfRdJbyW7WQ==","signatures":[{"sig":"MEUCIAGaB+gGtGvcWG9rWE+cyWtjohSDLUU6S/hdX6PV8SJ0AiEAxIQ9WIK0bzPSvWNO/9F1nL2iyTaB/xJOg25kFbKz0vI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blipr%2fmcp@0.4.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":33152},"type":"module","engines":{"node":">=18"},"gitHead":"3712ca1fd3e61fdcaab389736945ccd2628ff42d","scripts":{"test":"vitest run","build":"tsc","start":"node dist/index.js","prepare":"npm run build","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:9926f026-d15e-46ba-bfe6-9254473b92c4"}},"repository":{"url":"git+https://github.com/applogico/blipr-mcp.git","type":"git"},"_npmVersion":"12.0.2","description":"MCP server that lets AI agents send Blipr push alerts to your phone — your agent can page you.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.4.0_1785378417990_0.0784329457445101","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@blipr/mcp","version":"0.4.1","keywords":["mcp","modelcontextprotocol","blipr","notifications","push","alerts","apns","ai-agents","claude"],"author":{"name":"Applogico LLC"},"license":"MIT","_id":"@blipr/mcp@0.4.1","maintainers":[{"name":"cleverjam","email":"lizjaime@gmail.com"}],"homepage":"https://blipr.dev","bugs":{"url":"https://github.com/applogico/blipr-mcp/issues"},"bin":{"blipr-mcp":"dist/index.js"},"dist":{"shasum":"7de82bdd3e287fbf69f8fd320b64d6c983b5df80","tarball":"https://registry.npmjs.org/@blipr/mcp/-/mcp-0.4.1.tgz","fileCount":7,"integrity":"sha512-Iib39YDnDVSRQoH0EtPMV4YhtA1bE+SGDbIoFBGxUhOEKrgU2gqGjc14Vkkb6EMKac/nIEhGjTEuh4nRwp543g==","signatures":[{"sig":"MEQCICQNuHHoe3G+sTUdAr8aTxQpkWIeePjrLphrnC7T1I3cAiAhXSLFgauy05pqx70lloi4xKVI67o4J3qW1Zx0HxiyQg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blipr%2fmcp@0.4.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":33166},"type":"module","engines":{"node":">=18"},"gitHead":"79c26bf9b2a2521124f6b91bd5008629d2f83dbc","scripts":{"test":"vitest run","build":"tsc","start":"node dist/index.js","prepare":"npm run build","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:9926f026-d15e-46ba-bfe6-9254473b92c4"}},"repository":{"url":"git+https://github.com/applogico/blipr-mcp.git","type":"git"},"_npmVersion":"12.0.2","description":"MCP server that lets AI agents send Blipr push alerts to your phone — your agent can page you.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.4.1_1785701733069_0.3690680398646722","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@blipr/mcp","version":"0.5.0","keywords":["mcp","modelcontextprotocol","blipr","notifications","push","alerts","apns","ai-agents","claude"],"author":{"name":"Applogico LLC"},"license":"MIT","_id":"@blipr/mcp@0.5.0","maintainers":[{"name":"cleverjam","email":"lizjaime@gmail.com"}],"homepage":"https://blipr.dev","bugs":{"url":"https://github.com/applogico/blipr-mcp/issues"},"bin":{"blipr-mcp":"dist/index.js"},"dist":{"shasum":"ec5f6ef25cd4e804ae8037f61de3b9bf65c8227f","tarball":"https://registry.npmjs.org/@blipr/mcp/-/mcp-0.5.0.tgz","fileCount":7,"integrity":"sha512-WKd/VJcHotC36efyyleLGKLbZzRXJAEUFkJqWIghDxtyhUsfPzZEAbAY5kMZJxDxE3mZGYVeo8V6vN2kevuuYQ==","signatures":[{"sig":"MEYCIQDw8okLKbn/9xdyqZGRNwbZCZ1JuZV7bKLUcw2ZiJb3KAIhAPhIutVVnPpdT8UK/LDeDCrCeRsGbyk2+nRyNySnibeo","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blipr%2fmcp@0.5.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":34093},"type":"module","engines":{"node":">=18"},"gitHead":"84c331e71b8edafe4a502bf2dda963d6a640df44","scripts":{"test":"vitest run","build":"tsc","start":"node dist/index.js","prepare":"npm run build","test:watch":"vitest"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:1dd95650-1e18-4b14-a66b-359eebbd0101"}},"repository":{"url":"git+https://github.com/applogico/blipr-mcp.git","type":"git"},"_npmVersion":"12.0.2","description":"MCP server that lets AI agents send Blipr push alerts to your phone — your agent can page you.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.9","typescript":"^5.6.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.5.0_1786400644960_0.2593973036599444","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"_id":"@blipr/mcp@0.6.0","bin":{"blipr-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/applogico/blipr-mcp/issues"},"dist":{"shasum":"c3a98d2855a1535dc7d1ba63af93030125835664","tarball":"https://registry.npmjs.org/@blipr/mcp/-/mcp-0.6.0.tgz","fileCount":7,"integrity":"sha512-ZoKZ6zzn46t4AGFx6Vv+uOUvBj3pv/6BCJHd8qTSwUzNyCZ6eyGXZTb3Qtj0dpptdWkyFk5ohYKHlOAWxfLxnQ==","signatures":[{"sig":"MEQCIEBJq381Vxdr7b8J8gcTQ93ZMTiBy2jqb7vKW1IVXggbAiBiyacSrHU1qUiZLtcO+I9NqgeOu4WWLVQqGMK2DpLJHQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIC2lZXgXerl6kJSCnwDx91a3OENIm3XxirPsN7mySu5VAiAeVBTFO3a4KhxXeKPOahFKN+nKf1tK4yXkl2vLxni3XQ=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@blipr%2fmcp@0.6.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":34447},"name":"@blipr/mcp","type":"module","author":{"name":"Applogico LLC"},"engines":{"node":">=18"},"gitHead":"013333fd61354340a406ee8b20a782eabc512b25","license":"MIT","scripts":{"lint":"eslint .","test":"vitest run","build":"tsc","start":"node dist/index.js","prepare":"npm run build","test:watch":"vitest"},"version":"0.6.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"1dd95650-1e18-4b14-a66b-359eebbd0101"}},"homepage":"https://blipr.dev","keywords":["mcp","modelcontextprotocol","blipr","notifications","push","alerts","apns","ai-agents","claude"],"repository":{"url":"git+https://github.com/applogico/blipr-mcp.git","type":"git"},"_npmVersion":"12.1.0","description":"MCP server that lets AI agents send Blipr push alerts to your phone — your agent can page you.","directories":{},"maintainers":[{"name":"cleverjam","email":"lizjaime@gmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"eslint":"^9.39.2","vitest":"^4.1.9","@eslint/js":"^9.39.2","typescript":"^5.6.0","@types/node":"^22.0.0","typescript-eslint":"^8.51.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.6.0_1790641657567_0.8330104735598141"}}},"time":{"created":"2026-07-30T02:18:41.582Z","modified":"2026-09-29T00:27:38.311Z","0.3.1":"2026-07-30T02:18:41.964Z","0.4.0":"2026-07-30T02:26:58.136Z","0.4.1":"2026-08-02T20:15:33.201Z","0.5.0":"2026-08-10T22:24:05.088Z","0.6.0":"2026-09-29T00:27:37.648Z"},"bugs":{"url":"https://github.com/applogico/blipr-mcp/issues"},"author":{"name":"Applogico LLC"},"license":"MIT","homepage":"https://blipr.dev","keywords":["mcp","modelcontextprotocol","blipr","notifications","push","alerts","apns","ai-agents","claude"],"repository":{"url":"git+https://github.com/applogico/blipr-mcp.git","type":"git"},"description":"MCP server that lets AI agents send Blipr push alerts to your phone — your agent can page you.","maintainers":[{"name":"cleverjam","email":"lizjaime@gmail.com"}],"readme":"# @blipr/mcp\n\n[![npm version](https://img.shields.io/npm/v/@blipr/mcp)](https://www.npmjs.com/package/@blipr/mcp)\n[![CI](https://github.com/applogico/blipr-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/applogico/blipr-mcp/actions/workflows/ci.yml)\n[![license: MIT](https://img.shields.io/npm/l/@blipr/mcp)](./LICENSE)\n[![Node](https://img.shields.io/node/v/@blipr/mcp)](https://nodejs.org)\n\n> Previously published as `@applogico/blipr-mcp`. That package is deprecated;\n> new releases ship as **`@blipr/mcp`**. Update your MCP config to\n> `npx -y @blipr/mcp`.\n\nAn [MCP](https://modelcontextprotocol.io) server that lets AI agents send\n**[Blipr](https://blipr.dev)** push alerts to your phone. Your agent finishes a\nlong task, breaks a build, needs approval, or gets stuck — and it pages you. It\ncan also **ask you a question and block until you answer**, for human-in-the-loop\napproval gates.\n\nIt's a thin stdio client: your MCP host (Claude Code, Cursor, …) launches it,\nthe agent calls a tool, and this process makes one outbound HTTPS `POST` to your\nBlipr server. No inbound socket, nothing to host.\n\n```\nClaude Code ──stdio──► @blipr/mcp ──POST /blip/<topic>──► blipr.dev ──APNs──► 📱\n```\n\n## Setup\n\nNo install needed — `npx` fetches it on demand. Point it at a Blipr server\n(`blipr.dev` or your own self-hosted instance).\n\n### Claude Code\n\n```bash\nclaude mcp add blipr \\\n  --env BLIPR_URL=https://blipr.dev \\\n  -- npx -y @blipr/mcp\n```\n\n### Cursor / Claude Desktop / any MCP host (JSON)\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"blipr\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@blipr/mcp\"],\n      \"env\": {\n        \"BLIPR_URL\": \"https://blipr.dev\"\n      }\n    }\n  }\n}\n```\n\n### Pick a topic (per project, not global)\n\nEvery blip goes to a **topic**, and each project should use its own, so alerts\nfrom different projects land separately on your phone. The topic for a call is\nresolved in this order:\n\n1. **`topic` tool argument** — the agent passes it on the call. Always wins.\n2. **`.blipr-topic` file** — per-project default. Put the topic name on the\n   first line of a `.blipr-topic` file in the project root; the server picks up\n   the nearest one from its launch directory upward (`#` lines are comments).\n3. **`BLIPR_TOPIC` env var** — global fallback, kept for backward\n   compatibility. Avoid it when one machine hosts several projects: a global\n   default makes every project ping the same topic.\n\n```bash\necho my-project-alerts > .blipr-topic\n```\n\nThen subscribe to the same topic (`my-project-alerts`) in the Blipr iOS app,\nand you'll get the agent's pushes on your phone. On blipr.dev that subscribe,\nmade while signed in, is also what creates the topic, so do it before the\nagent's first blip: publishing to a topic that does not exist returns 404. A\nself-hosted server still creates the topic on the first publish.\n\n## Configuration\n\n| Setting                    | Default             | Description                                                                 |\n| -------------------------- | ------------------- | --------------------------------------------------------------------------- |\n| `BLIPR_URL` (env)          | `https://blipr.dev` | Base URL of your Blipr server (hosted or self-hosted).                      |\n| `.blipr-topic` (file)      | _(none)_            | Per-project default topic, nearest file from the launch directory upward.   |\n| `BLIPR_TOPIC` (env)        | _(none)_            | Global fallback topic; lowest precedence (see \"Pick a topic\" above).        |\n\n## Tools\n\n### `send_alert`\n\nSend a push notification. Parameters:\n\n- `message` (required) — the alert body.\n- `title` — short bold title.\n- `topic` — topic to publish to; pass it explicitly (falls back to\n  `.blipr-topic`, then `BLIPR_TOPIC`).\n- `priority` — `1` silent · `2` low · `3` default · `4` high (plays a sound,\n  respects Focus) · `5` critical (breaks Focus).\n- `tags` — emoji shortcodes, e.g. `[\"warning\"]`.\n- `click` — URL opened when the notification is tapped.\n- `markdown`: render the body as Markdown (bold, italics, links, code). Off by default.\n\n### `send_critical`\n\nA priority-5 page for things that genuinely can't wait. Bypasses silent/Focus\nwhen the Blipr app has Apple's Critical Alerts entitlement enabled; otherwise\nit's delivered as time-sensitive. Also takes `markdown`.\n\n### `ask` — human-in-the-loop yes/no (blocks)\n\nSend a **yes/no question** to your phone and **block until you tap an answer**,\nthen return it. This is an approval gate: the agent calls it before doing\nsomething consequential or irreversible and waits for your decision instead of\nguessing.\n\n- `message` (required) — the yes/no question.\n- `title` — short bold title.\n- `topic` — topic to publish to; pass it explicitly (falls back to\n  `.blipr-topic`, then `BLIPR_TOPIC`).\n- `priority` — defaults to `4` (high) since it needs an answer.\n- `tags` — emoji shortcodes, e.g. `[\"question\"]`.\n- `markdown`: render the body as Markdown (bold, italics, links, code). Off by default.\n- `timeout_seconds` — how long to wait for your answer (default `120`).\n\nReturns `{ responded, approved, value, message_id, topic }`. **Branch on\n`approved`** — it is `true` **only** when you tapped Yes, and `false` on No, a\ntimeout, or an error, so a refusal or non-answer can never be misread as a\ngo-ahead. On a timeout you get\n`{ responded: false, approved: false, reason: \"timeout\", message_id, topic }`. If\nit times out (or your MCP client cancels the call), you can still answer for\n~30 min — pass the returned `message_id` to `check_reply` to resume.\n\nUnder the hood it publishes with `reply: \"binary\"`, captures the message `id`\nfrom the publish response, then long-polls\n`GET /blip/<topic>/<id>/reply?wait=…` until you answer or the timeout\nbudget runs out.\n\n### `request_ack` — require acknowledgement (blocks)\n\nSend a message that you must **acknowledge**, and **block until you tap\n\"Acknowledge\"**. Use it when the human has to see and confirm something before\nthe agent continues. Same parameters as `ask`; publishes with `reply: \"ack\"`.\n\nReturns `{ responded, message_id, topic }` plus `replied_at` when acked, or\n`{ responded: false, reason: \"timeout\", … }`. As with `ask`, on a timeout you can\nresume later with `check_reply` and the returned `message_id`.\n\n### `check_reply` — resume / poll an earlier ask or request_ack\n\nLook up whether you've replied to an earlier `ask`/`request_ack` — handy if the\nblocking call timed out or your MCP client cancelled it. Pass the `message_id`\n(and `topic`) it returned; non-blocking by default, or set `wait_seconds` to\nbriefly long-poll. Returns `{ responded, value?, replied_at? }` (`value` is\n`\"yes\"` / `\"no\"` / `\"ack\"`). Replies are kept ~30 minutes after the original\nmessage was sent.\n\n## Example prompts\n\n> \"Run the migration, and `send_alert` me when it's done — priority 4 if it\n> fails.\"\n\n> \"If the nightly backup fails, `send_critical` me with the error — that one\n> can't wait.\"\n\n> \"Before you `DROP` the production table, `ask` me to approve it — only proceed\n> if I answer yes.\"\n\nA concrete approval-gate flow:\n\n```\nAgent: about to delete the prod `events` table → calls\n       ask(\"Delete prod `events` table (12M rows)? This cannot be undone.\")\n        … blocks; your phone buzzes …\nYou:   tap \"No\"\nAgent: ask returns { responded: true, approved: false, value: \"no\" } → aborts the deletion.\n```\n\n## Develop\n\n```bash\nnpm install\nnpm run build      # → dist/index.js\nnpm test           # vitest: unit (publish, config) + in-memory MCP integration\nBLIPR_URL=https://blipr.dev BLIPR_TOPIC=demo node dist/index.js   # stdio\n```\n\n## License\n\nMIT © Applogico LLC. This is the open client adapter; the Blipr server is\ndistributed as a container image.\n","readmeFilename":"README.md"}