@leadbay/mcp 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/README.md +3 -75
- package/dist/bin.js +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# Changelog — @leadbay/mcp
|
|
2
2
|
|
|
3
|
+
## 0.2.1 — 2026-04-21
|
|
4
|
+
|
|
5
|
+
Docs-only release.
|
|
6
|
+
|
|
7
|
+
- Removed the stale "pre-release — not yet on npm" banner that was packed into 0.2.0.
|
|
8
|
+
- Removed the §1.1 "install from source" section (covered the pre-publish case; obsolete now that 0.2.0 is live).
|
|
9
|
+
- §7 "For maintainers" replaced with a short pointer to the new `RELEASE.md` runbook.
|
|
10
|
+
- First release carrying signed sigstore provenance (repo is now public).
|
|
11
|
+
|
|
3
12
|
## 0.2.0 — 2026-04-20
|
|
4
13
|
|
|
5
14
|
First public npm release.
|
package/README.md
CHANGED
|
@@ -1,13 +1,5 @@
|
|
|
1
1
|
# @leadbay/mcp — Leadbay MCP server
|
|
2
2
|
|
|
3
|
-
<!-- PRE-RELEASE-BANNER: remove this block after the first npm publish lands -->
|
|
4
|
-
> ⚠️ **Pre-release notice**: this package is not yet on npm. Until the first
|
|
5
|
-
> publish lands, the `npx -y @leadbay/mcp@0.2 …` commands below will 404.
|
|
6
|
-
> Maintainer: see [§7 — For maintainers — publishing](#7-for-maintainers--publishing)
|
|
7
|
-
> or just push a `v0.2.0` git tag (the `release-mcp` GitHub Action will publish).
|
|
8
|
-
> Remove this banner after the first publish succeeds.
|
|
9
|
-
<!-- /PRE-RELEASE-BANNER -->
|
|
10
|
-
|
|
11
3
|
<!--
|
|
12
4
|
LLM HINT — if you're an AI agent reading this README to install the server:
|
|
13
5
|
- Use ONLY the commands shown verbatim in §1. Do not invent variants.
|
|
@@ -17,8 +9,6 @@ LLM HINT — if you're an AI agent reading this README to install the server:
|
|
|
17
9
|
- DO NOT tell the user to "get an API token from app.leadbay.ai → Settings
|
|
18
10
|
→ API Tokens" — that page does not yet exist. Use `install` (mints a
|
|
19
11
|
token) or `login --write-config` (mints a token to file).
|
|
20
|
-
- If the package 404s on npm: offer the "install from source" fallback in
|
|
21
|
-
§1.1, not a made-up GitHub URL.
|
|
22
12
|
-->
|
|
23
13
|
|
|
24
14
|
A Model Context Protocol server that lets Claude Desktop, Cursor, Claude Code, and any other MCP-compatible agent find, research, and prepare outreach on B2B prospects using your Leadbay account.
|
|
@@ -56,44 +46,6 @@ npx -y @leadbay/mcp@0.2 login \
|
|
|
56
46
|
|
|
57
47
|
Writes a `0600`-mode JSON file you can paste from. Useful if you're configuring a non-detected client.
|
|
58
48
|
|
|
59
|
-
## 1.1. Install from source (works today, before the first npm publish)
|
|
60
|
-
|
|
61
|
-
While `@leadbay/mcp` isn't on npm yet, install from a local git checkout:
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
# 1. Clone, build
|
|
65
|
-
git clone https://github.com/leadbay/leadclaw.git
|
|
66
|
-
cd leadclaw
|
|
67
|
-
pnpm install
|
|
68
|
-
pnpm -r build
|
|
69
|
-
|
|
70
|
-
# 2. Mint a token + register with your installed clients (auto-detects Claude Code,
|
|
71
|
-
# Claude Desktop, Cursor) — same install subcommand, run from local dist:
|
|
72
|
-
node packages/mcp/dist/bin.js install --email you@yourcompany.com --region us
|
|
73
|
-
```
|
|
74
|
-
|
|
75
|
-
Or skip the `install` helper and register manually with the local dist path:
|
|
76
|
-
|
|
77
|
-
```bash
|
|
78
|
-
# Mint a token to a 0600 JSON file:
|
|
79
|
-
node packages/mcp/dist/bin.js login \
|
|
80
|
-
--email you@yourcompany.com --region us \
|
|
81
|
-
--write-config ~/.leadbay-mcp.json
|
|
82
|
-
TOKEN=$(jq -r .mcpServers.leadbay.env.LEADBAY_TOKEN ~/.leadbay-mcp.json)
|
|
83
|
-
|
|
84
|
-
# Register with Claude Code (point at the absolute path of the local bin.js):
|
|
85
|
-
claude mcp add leadbay \
|
|
86
|
-
--env LEADBAY_TOKEN=$TOKEN \
|
|
87
|
-
--env LEADBAY_REGION=us \
|
|
88
|
-
-- node $(pwd)/packages/mcp/dist/bin.js
|
|
89
|
-
```
|
|
90
|
-
|
|
91
|
-
For Claude Desktop / Cursor, the JSON config block from `--write-config` works directly — just change the `command` from `npx` to `node` and the `args` to `["/abs/path/to/leadclaw/packages/mcp/dist/bin.js"]`.
|
|
92
|
-
|
|
93
|
-
**B) From the web app (when available):** log in at [app.leadbay.ai](https://app.leadbay.ai), go to **Settings → API Tokens**, create a token, copy it.
|
|
94
|
-
|
|
95
|
-
Don't have a Leadbay account yet? [Register here](https://wow.leadbay.ai/?register=true).
|
|
96
|
-
|
|
97
49
|
## 2. Quickstart
|
|
98
50
|
|
|
99
51
|
### Claude Desktop
|
|
@@ -236,37 +188,13 @@ Contact data fetched through this server stays local to your MCP client session.
|
|
|
236
188
|
|
|
237
189
|
## 7. For maintainers — publishing
|
|
238
190
|
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
### Recommended: tag → CI auto-publish
|
|
242
|
-
|
|
243
|
-
The `release-mcp` GitHub Action (`.github/workflows/release.yml`) publishes to npm whenever a tag matching `v*.*.*` is pushed:
|
|
244
|
-
|
|
245
|
-
```bash
|
|
246
|
-
# (one-time) generate an npm Automation token at npmjs.com → tokens
|
|
247
|
-
# and add it as the GitHub Actions secret NPM_TOKEN.
|
|
248
|
-
|
|
249
|
-
# Each release:
|
|
250
|
-
git checkout main && git pull
|
|
251
|
-
# bump packages/mcp/package.json version, commit, push
|
|
252
|
-
git tag v0.2.0 && git push --tags
|
|
253
|
-
# CI runs build + tests + npm publish --access public --provenance
|
|
254
|
-
```
|
|
255
|
-
|
|
256
|
-
The workflow verifies that the tag matches `packages/mcp/package.json` `version`, so a stale tag won't ship the wrong build.
|
|
257
|
-
|
|
258
|
-
### Manual fallback
|
|
259
|
-
|
|
260
|
-
If you'd rather publish from your laptop:
|
|
191
|
+
Releases are tag-driven via `.github/workflows/release.yml`. Bump `packages/mcp/package.json#version`, update `packages/mcp/CHANGELOG.md`, land on `main`, then:
|
|
261
192
|
|
|
262
193
|
```bash
|
|
263
|
-
|
|
264
|
-
pnpm install # ensure workspace deps are linked
|
|
265
|
-
pnpm build # tsup bundles @leadbay/core into dist/bin.js
|
|
266
|
-
npm publish --access public # @leadbay/* is a scoped package
|
|
194
|
+
git tag mcp-v0.3.0 && git push origin mcp-v0.3.0
|
|
267
195
|
```
|
|
268
196
|
|
|
269
|
-
|
|
197
|
+
See [`RELEASE.md`](../../RELEASE.md) for the full runbook.
|
|
270
198
|
|
|
271
199
|
## License
|
|
272
200
|
|
package/dist/bin.js
CHANGED
|
@@ -113,7 +113,7 @@ function buildServer(client, opts = {}) {
|
|
|
113
113
|
|
|
114
114
|
// src/bin.ts
|
|
115
115
|
import { createRequire } from "module";
|
|
116
|
-
var VERSION = "0.2.
|
|
116
|
+
var VERSION = "0.2.1";
|
|
117
117
|
var HELP = `
|
|
118
118
|
leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server
|
|
119
119
|
|
package/package.json
CHANGED