@50heads/mcp 2026.925.1 → 2026.1006.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 +13 -2
- package/README.md +7 -4
- package/dist/cli.js +1900 -1035
- package/dist/index.js +1901 -1036
- package/dist/types/apps.d.ts +23 -1
- package/dist/types/cli/stdio.d.ts +119 -2
- package/dist/types/constants.d.ts +3 -2
- package/dist/types/generated/skill.d.ts +1 -1
- package/dist/types/manifest.d.ts +0 -1
- package/dist/types/pricing.d.ts +7 -1
- package/dist/types/schemas.d.ts +147 -0
- package/package.json +5 -6
- package/server.json +4 -5
- package/skills/50heads/SKILL.md +1 -1
- package/skills/50heads/references/pricing.md +2 -2
- package/skills/50heads/references/tools.md +3 -2
- package/skills/50heads/scripts/estimate.py +31 -3
- package/skills/50heads.zip +0 -0
package/CHANGELOG.md
CHANGED
|
@@ -8,13 +8,24 @@ Add what changed under Unreleased as you go, written for the people using it. Th
|
|
|
8
8
|
|
|
9
9
|
## [Unreleased]
|
|
10
10
|
|
|
11
|
+
## [2026.1006.1] - 2026-10-06
|
|
12
|
+
|
|
13
|
+
### Added
|
|
14
|
+
|
|
15
|
+
- `list_audiences`: interest audiences, panels of heads who proved they fit (UK commuter cyclists, for example), with their countries, size band and price per answer by grade.
|
|
16
|
+
- `audience` on a question (`{ id, min_grade }`) for `estimate`, `ask` and the other tools that take one. It replaces `targeting`; the price per answer is the audience's at the minimum grade, with no trait credits.
|
|
17
|
+
|
|
18
|
+
## [2026.925.2] - 2026-09-25
|
|
19
|
+
|
|
20
|
+
Maintenance release. No change to tools, resources or prompts.
|
|
21
|
+
|
|
11
22
|
## [2026.925.1] - 2026-09-25
|
|
12
23
|
|
|
13
24
|
### Added
|
|
14
25
|
|
|
15
26
|
- First public release: tools `estimate`, `ask`, `get_results`, `wait_for_results`, `list_questions`, `cancel`, `templates` and `balance`, the 50heads Agent Skill, and `login`, `status`, `logout` and `config` on the command line.
|
|
16
|
-
-
|
|
27
|
+
- Registry manifest `server.json` for `com.50heads/mcp`, hosted and npm. The official registry listing was not published: the registry returns no servers for that name until `MCP_REGISTRY_ED25519_KEY` is set on the release workflow.
|
|
17
28
|
- The skill bundle is attached to each GitHub Release as `50heads-skill.zip` and served at `https://50heads.com/skills/50heads.zip`.
|
|
18
29
|
- Requests from the CLI carry a `User-Agent` of `50heads-mcp/<version>`.
|
|
19
|
-
- Nine more tools: `upload_image` (base64 or an https link), `get_answers` (paged and filtered), `add_heads`, `flag_answer`, `export` (CSV,
|
|
30
|
+
- Nine more tools: `upload_image` (base64 or an https link), `get_answers` (paged and filtered), `add_heads`, `flag_answer`, `export` (CSV, PDF and PNG), `build_ask_link` (a pre-filled portal link), `list_targeting`, `search_help` and `send_feedback`.
|
|
20
31
|
|
package/README.md
CHANGED
|
@@ -1,6 +1,8 @@
|
|
|
1
1
|
# 50heads MCP
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
<!-- lead:start (generated from src/pricing.ts by scripts/generate.ts; do not edit by hand) -->
|
|
4
|
+
Ask fifty verified real people a five-second question from Claude, ChatGPT, Cursor or your own agent, and get the split back. 50 answers at Tier 1: about 10 minutes and 1000 credits, priced in your account's currency.
|
|
5
|
+
<!-- lead:end -->
|
|
4
6
|
|
|
5
7
|
There are two ways in, with the same tools:
|
|
6
8
|
|
|
@@ -220,6 +222,7 @@ npx -y @50heads/mcp logout
|
|
|
220
222
|
| `flag_answer` | questions:write | Reports one answer by its `attestation_ref` for review; upheld flags are refunded. |
|
|
221
223
|
| `export` | questions:read | The results as a file: CSV, a one-page PDF report, or a PNG chart (square, wide or story). |
|
|
222
224
|
| `build_ask_link` | none | A portal link with the question filled in, for a person to check and ask. Spends nothing. |
|
|
225
|
+
| `list_audiences` | none | Interest audiences you can ask instead of targeting, with prices by grade. |
|
|
223
226
|
| `list_targeting` | none | Countries, languages, pool bands and the tags you can target. |
|
|
224
227
|
| `search_help` | none | Searches the help centre and returns articles with links. |
|
|
225
228
|
| `send_feedback` | none | Sends feedback or a problem to support as a ticket (signed out: add `email`). |
|
|
@@ -248,9 +251,9 @@ serveStdio(serverFactory({ apiKey: process.env.FIFTYHEADS_API_KEY }));
|
|
|
248
251
|
|
|
249
252
|
## Versions
|
|
250
253
|
|
|
251
|
-
Releases use calendar versions, `YYYY.MDD.N`: `2026.924.1` is the first release on 24 September 2026, and a second that day is `2026.924.2`. The npm package, the hosted server (`serverInfo.version`), the
|
|
254
|
+
Releases use calendar versions, `YYYY.MDD.N`: `2026.924.1` is the first release on 24 September 2026, and a second that day is `2026.924.2`. The npm package, the hosted server (`serverInfo.version`), the registry manifest, `--version` and the Agent Skill all carry the same number. See [CHANGELOG.md](./CHANGELOG.md).
|
|
252
255
|
|
|
253
|
-
|
|
256
|
+
`server.json` is ready for the official MCP Registry as `com.50heads/mcp`. The registry has no listing yet (a search returns no servers). Publishing it needs `MCP_REGISTRY_ED25519_KEY` on the release workflow. See [docs/publishing.md](../../docs/publishing.md). The npm package itself is published.
|
|
254
257
|
|
|
255
258
|
## Development
|
|
256
259
|
|
|
@@ -262,6 +265,6 @@ pnpm --filter @50heads/mcp test
|
|
|
262
265
|
pnpm --filter @50heads/mcp build # dist/cli.js, dist/index.js, types, skills/ and skills/50heads.zip
|
|
263
266
|
```
|
|
264
267
|
|
|
265
|
-
Releasing (npm with provenance, the MCP Registry and a GitHub Release
|
|
268
|
+
Releasing (npm with provenance from the public mirror, the MCP Registry and a GitHub Release) is described in [docs/publishing.md](../../docs/publishing.md).
|
|
266
269
|
|
|
267
270
|
MIT licence.
|