@mackody/quickenrich-mcp 0.1.0 → 0.1.2

package/.codex-plugin/plugin.json

@@ -1,13 +1,13 @@
 {
   "name": "quickenrich-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Standalone MCP server and CLI for Quick Enrich lead enrichment APIs.",
   "author": {
     "name": "Cody Robertson"
   },
   "homepage": "https://app.quickenrich.io/docs",
   "repository": "https://github.com/codyrobertson/quickenrich-mcp",
-  "license": "UNLICENSED",
+  "license": "SEE LICENSE IN LICENSE.md",
   "keywords": [
     "quickenrich",
     "quick-enrich",

package/LICENSE.md

@@ -0,0 +1,59 @@
+# Quick Enrich MCP Restricted License
+
+Copyright (c) 2026 Cody Robertson. All rights reserved.
+
+This software is not open source. The package is published for controlled installation, review, and internal evaluation only. No rights are granted except the limited rights expressly stated in this license.
+
+## 1. Limited Permitted Use
+
+You may install, run, inspect, and test this software solely for internal evaluation, internal development, and integration planning.
+
+This permission is personal, non-exclusive, non-transferable, revocable, and non-sublicensable.
+
+## 2. No Commercial, Production, or Payment-Gated Use
+
+You may not use this software, in whole or in part, for any commercial, production, revenue-generating, customer-facing, or payment-gated purpose without prior written permission from Cody Robertson or an authorized Mackody representative.
+
+Prohibited uses include, without limitation:
+
+- integrating this software into any commercial product, SaaS, hosted service, agent platform, automation platform, marketplace listing, CRM, enrichment platform, prospecting platform, customer deliverable, or managed service;
+- making this software available behind subscriptions, paid seats, usage-based billing, credits, checkout, payment processing, paid API access, or any other monetization mechanism;
+- using this software to provide lead enrichment, prospecting, data enrichment, automation, implementation, consulting, or agency services to third parties;
+- bundling, embedding, white-labeling, reselling, sublicensing, leasing, renting, or otherwise commercially distributing this software;
+- using this software to compete with, replace, or commercially replicate Quick Enrich, Mackody, or their related services.
+
+## 3. No Redistribution
+
+You may not copy, publish, mirror, redistribute, repackage, upload, or make this software available to any third party except as expressly authorized in writing.
+
+You may not remove, obscure, or alter copyright notices, license notices, package metadata, or attribution notices.
+
+## 4. API, Credentials, and Rate Limits
+
+This license does not grant access to Quick Enrich APIs, data, credentials, trademarks, or services. You must use your own authorized Quick Enrich API key and comply with Quick Enrich's API documentation, account terms, data rules, and published rate limits.
+
+You may not use this software to bypass, evade, overload, or work around Quick Enrich limits, billing, credit accounting, authentication, authorization, or abuse controls.
+
+## 5. Ownership
+
+Cody Robertson and/or Mackody retain all right, title, and interest in and to this software, including all intellectual property rights. No implied licenses are granted.
+
+Feedback, suggestions, bug reports, or proposed changes may be used without restriction or compensation unless separately agreed in writing.
+
+## 6. Termination
+
+Any use outside this license automatically terminates your rights immediately. Upon termination, you must stop using the software and delete all copies in your possession or control.
+
+## 7. Commercial Permission
+
+Commercial, production, hosted, payment-gated, customer-facing, or third-party use requires a separate written license or written approval from Cody Robertson or an authorized Mackody representative before use begins.
+
+## 8. Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AVAILABILITY, ACCURACY, OR ERROR-FREE OPERATION.
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, CODY ROBERTSON, MACKODY, AND THEIR AFFILIATES WILL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, OR FOR LOST PROFITS, LOST REVENUE, LOST DATA, BUSINESS INTERRUPTION, API CHARGES, CREDIT USAGE, OR PROCUREMENT OF SUBSTITUTE SERVICES.
+
+## 9. No Waiver
+
+Failure to enforce any provision of this license is not a waiver. If any provision is held unenforceable, the remaining provisions remain in effect.

package/README.md

@@ -1,54 +1,112 @@
 # Quick Enrich MCP
 
-Standalone MCP server for Quick Enrich's documented APIs. It is built for internal prospecting workflows: secure local API-key storage, exact person enrichment, reverse-email/phone lookup, domain lead pulls, contact/company finder calls, and compact batch envelopes for agent use.
+NPM package: [`@mackody/quickenrich-mcp`](https://www.npmjs.com/package/@mackody/quickenrich-mcp)
+
+Standalone MCP server and CLI for Quick Enrich's documented APIs. It is built for internal prospecting workflows: secure local API-key storage, exact person enrichment, reverse-email/phone lookup, domain lead pulls, contact/company finder calls, CSV/JSONL workflows, and compact batch envelopes for agent use.
 
 Docs source: [Quick Enrich API Documentation](https://app.quickenrich.io/docs).
 
-## Install
+## License
 
-```bash
-npm install
-npm run test
-```
+This package is not open source. It is published under the [Quick Enrich MCP Restricted License](./LICENSE.md) for controlled internal evaluation only.
+
+Commercial, production, hosted, payment-gated, customer-facing, SaaS, resale, agency, consulting, marketplace, or third-party service integrations require prior written permission from Cody Robertson or an authorized Mackody representative.
 
-Package/agent setup after install:
+## Install From NPM
 
 ```bash
+npm install -g @mackody/quickenrich-mcp
 quickenrich-token set
 quickenrich-token doctor
-quickenrich-agent-docs install --cwd /path/to/agent-project
 ```
 
-`quickenrich-agent-docs install` appends exactly two managed Quick Enrich how-to-use lines to `CLAUDE.md` and `AGENTS.md` in the target project. It is idempotent. Remove those managed lines with:
+Requires Node.js 20 or newer.
+
+You can also run without a global install:
 
 ```bash
-quickenrich-agent-docs uninstall --cwd /path/to/agent-project
+npx -p @mackody/quickenrich-mcp quickenrich-token set
+npx -y @mackody/quickenrich-mcp
 ```
 
-Set an API key with either an environment variable:
+## MCP Client Config
 
-```bash
-export QUICKENRICH_API_KEY=...
+Global install config:
+
+```json
+{
+  "mcpServers": {
+    "quick-enrich": {
+      "command": "quickenrich-mcp",
+      "env": {
+        "QUICKENRICH_MCP_TOOL_MODE": "agent",
+        "QUICKENRICH_MCP_RESPONSE_MODE": "compact"
+      }
+    }
+  }
+}
 ```
 
-or the local secure config:
+No-install `npx` config:
+
+```json
+{
+  "mcpServers": {
+    "quick-enrich": {
+      "command": "npx",
+      "args": ["-y", "@mackody/quickenrich-mcp"],
+      "env": {
+        "QUICKENRICH_MCP_TOOL_MODE": "agent",
+        "QUICKENRICH_MCP_RESPONSE_MODE": "compact"
+      }
+    }
+  }
+}
+```
+
+MCP server alias: `quick-enrich`
+
+Use `QUICKENRICH_MCP_TOOL_MODE=minimal` for only auth, graph, natural-language planning, and batch pull. Use `QUICKENRICH_MCP_TOOL_MODE=full` when you want every low-level endpoint and verbose schema descriptions. Default `agent` mode is the recommended NPM install mode.
+
+## Auth
 
 ```bash
-node scripts/quickenrich-token.mjs set
-node scripts/quickenrich-token.mjs status
+quickenrich-token set
+quickenrich-token status
+quickenrich-token doctor
 ```
 
 The token CLI stores the key at `~/.config/quickenrich-mcp/config.json` with `0600` permissions. Env vars override the config file.
 
-## MCP
+For CI or ephemeral MCP hosts, set:
+
+```bash
+export QUICKENRICH_API_KEY=...
+```
 
-Use the bundled `.mcp.json` or run directly:
+## Agent Project Setup
+
+After installing the package, add the two managed agent hints to a project:
 
 ```bash
-node scripts/quickenrich-mcp.mjs
+quickenrich-agent-docs install --cwd /path/to/agent-project
 ```
 
-MCP server alias: `quick-enrich`
+`quickenrich-agent-docs install` appends exactly two Quick Enrich how-to-use lines to `CLAUDE.md` and `AGENTS.md`. It is idempotent.
+
+Remove those managed lines with:
+
+```bash
+quickenrich-agent-docs uninstall --cwd /path/to/agent-project
+```
+
+## Package Binaries
+
+- `quickenrich-mcp`: stdio MCP server.
+- `quickenrich-token`: secure local API-key setup and auth diagnostics.
+- `quickenrich-agent-docs`: install/uninstall agent usage hints in `CLAUDE.md` and `AGENTS.md`.
+
+## Agent Tool Surface
 
 Default agent tools:
 
@@ -76,8 +134,6 @@ Full-mode tools (`QUICKENRICH_MCP_TOOL_MODE=full`) also expose:
 - `quickenrich_batch_pull_leads`
 - `quickenrich_lookup_values`
 
-Use `QUICKENRICH_MCP_TOOL_MODE=minimal` for only auth, graph, natural-language planning, and batch pull. Use `QUICKENRICH_MCP_TOOL_MODE=full` when you want every low-level endpoint and verbose schema descriptions.
-
 Default agent mode intentionally emits slim schemas and short tool descriptions so cold agents do not spend context on prose they can recover from `quickenrich_agent_graph`. The default `tools/list` surface is budgeted under 8 KB and includes lookup discovery because finder filters need valid country, industry, employee-range, revenue-range, and service values.
 
 Responses default to compact mode with a 12 KB output budget, 12 array items, 48 object keys, depth 4, and 240-character strings. Pass `response: { "mode": "full", "maxOutputChars": 64000 }` for rawer output, or `response: { "mode": "meta" }` for shape-only output.
@@ -174,7 +230,7 @@ Domain batch pulls use a shared token-bucket limiter per MCP client plus a rolli
 ```bash
 QUICKENRICH_DOMAIN_SEARCH_REQUESTS_PER_MINUTE=300 \
 QUICKENRICH_DOMAIN_SEARCH_BURST_SIZE=8 \
-node scripts/quickenrich-mcp.mjs
+quickenrich-mcp
 ```
 
 The batch result includes `throttle` metadata showing the active ceiling, burst, total acquired slots, and sleep time. Repeated calls through the same MCP process share buckets, so follow-up batches do not reset the burst. If a final 429 includes `Retry-After`, the limiter cools down before later starts.
@@ -183,7 +239,18 @@ Use `throttle_scope:"shared"` to coordinate the rolling request ceiling across m
 
 Other batch lanes also use small compliant default bursts: employee search, phone search, and reverse email default to `burst_size=16`; Contact Finder and Company Finder default to `burst_size=4`.
 
-## Smoke Tests
+## Source Development
+
+Clone the repo only if you are developing the package itself:
+
+```bash
+git clone https://github.com/codyrobertson/quickenrich-mcp.git
+cd quickenrich-mcp
+npm install
+npm run smoke
+```
+
+Run the full local plus live suite when a Quick Enrich key is configured:
 
 ```bash
 npm run test
@@ -265,19 +332,3 @@ Latest default token-bucket paid local run on 2026-07-09:
 - `direct_core_batch`: 266.64 ms, 2 requests, 2 credits, 2 leads.
 - `mcp_batch_stdio`: 318.64 ms, 2 requests, 2 credits, 2 leads.
 - Result: MCP stdio batch was 2.09x faster than naive raw sequential API usage, cut request volume 2x, and saved 50% credits on duplicate inputs.
-
-## NPM Publish Prep
-
-Dry-run the package contents before publishing:
-
-```bash
-npm run check
-npm run smoke
-npm run pack:dry-run
-```
-
-Actual publish is intentionally manual:
-
-```bash
-npm publish --access public
-```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mackody/quickenrich-mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "Standalone MCP server and CLI for Quick Enrich lead enrichment APIs.",
   "bin": {
@@ -15,6 +15,7 @@
     "agents/",
     "scripts/",
     "skills/",
+    "LICENSE.md",
     "README.md"
   ],
   "scripts": {
@@ -36,5 +37,5 @@
   "engines": {
     "node": ">=20"
   },
-  "license": "UNLICENSED"
+  "license": "SEE LICENSE IN LICENSE.md"
 }