@50heads/mcp 2026.925.2 → 2026.1009.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 CHANGED
@@ -1,24 +1,73 @@
1
1
  # Changelog
2
2
 
3
- Changes to `@50heads/mcp` (the `npx @50heads/mcp` stdio server and CLI), the hosted server at `https://mcp.50heads.com/mcp` and the 50heads Agent Skill. They share one version.
3
+ Changes to `@50heads/mcp` (the `npx @50heads/mcp` server and command), the hosted server at `https://mcp.50heads.com/mcp`, and the 50heads Agent Skill. They share one version.
4
4
 
5
- The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versions are calendar versions, `YYYY.MDD.N`: the year, the month and two-digit day, then the release number for that day (`2026.924.1` is the first release on 24 September 2026). Breaking changes are called out in the notes.
5
+ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versions are calendar versions, `YYYY.MDD.N`: the year, the month and two-digit day, then the release number for that UTC day (`2026.924.1` is the first release on 24 September 2026).
6
6
 
7
- Add what changed under Unreleased as you go, written for the people using it. The release workflow moves it under the new version and uses it for the GitHub Release.
7
+ Pending changes are captured as changesets and written here when the package is released. The GitHub Release uses the same notes.
8
8
 
9
9
  ## [Unreleased]
10
10
 
11
+ ## [2026.1009.1] - 2026-10-09
12
+
13
+ **This release adds ask_set for ordered question sets behind one shared link, plus public results for ask and ask_set.** It also updates answer options, language support, shared-link closing, and answer flagging rules.
14
+
15
+ ### Added
16
+
17
+ - **ask_set now publishes 2 to 10 questions for your own audience behind one shared link, answered in order, with each question keeping its own results.**
18
+ - **Questions can now set answered_by to private, and results show whether heads answered in the app or people answered through the shared link; for heads, that line names the tier and how they were verified.**
19
+ - **ask and ask_set now take public_results, off by default; when on, a question asked of heads has a shareable results page, and people who answer through a shared link see the bars after their own answer.**
20
+ - **Questions can now use Japanese, Korean, Swedish, Danish, Norwegian, Czech, Romanian, Finnish or Turkish, as well as English, French, Spanish, Portuguese, Italian, German, Dutch and Polish.**
21
+ - **list_questions now takes set_id and lists only that set, in order, with each question's place in the set.**
22
+
23
+ ### Changed
24
+
25
+ - **yes_no is now Yes or No, and yes_mostly_no is the opt-in that adds Mostly.**
26
+ - **Descriptions now say verified people.**
27
+ - **When a shared link closes, the question status is closed and the unused reserve is refunded.**
28
+ - **flag_answer cannot flag an answer that came through a shared link, because that answer has no attestation reference.**
29
+
30
+ ## [2026.1006.1] - 2026-10-06
31
+
32
+ **Interest audiences can be listed and asked, in place of targeting.**
33
+
34
+ ### Added
35
+
36
+ - **`list_audiences` lists interest audiences, panels of heads who proved they fit (UK commuter cyclists, for example), with their countries, a size band and the price per answer by grade.**
37
+ - **`audience` on a question (`id` and `min_grade`) works on `estimate`, `ask` and the other tools that take a question.** It replaces `targeting`. The price per answer is the audience's at the minimum grade, with no trait credits.
38
+
39
+ ### Changed
40
+
41
+ - **The skill's estimate script sends a user agent of `50heads-skill/<version>`.**
42
+ - **The skill's tool notes state that `export` serves CSV, PDF and PNG.**
43
+
11
44
  ## [2026.925.2] - 2026-09-25
12
45
 
13
- Maintenance release. No change to tools, resources or prompts.
46
+ **The estimate card and the daily spend cap are clearer.** No new tools.
47
+
48
+ ### Changed
49
+
50
+ - **The estimate card keeps its height while the price is worked out.** The Ask button stays on the card, disabled, until the quote arrives. The card shows credits per head and how many heads could answer.
51
+ - **A connection's daily spend cap is given in credits, so the figure does not move with the exchange rate.**
52
+
53
+ ### Fixed
54
+
55
+ - **The estimate and results views declare a content security policy with no outside hosts, and a border, so ChatGPT does not treat the policy as missing.**
14
56
 
15
57
  ## [2026.925.1] - 2026-09-25
16
58
 
59
+ **First public release of the 50heads MCP server, the command and the Agent Skill.**
60
+
17
61
  ### Added
18
62
 
19
- - 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.
20
- - Listed in the official MCP Registry as `com.50heads/mcp`, with the hosted server and the npm package.
21
- - The skill bundle is attached to each GitHub Release as `50heads-skill.zip` and served at `https://50heads.com/skills/50heads.zip`.
22
- - Requests from the CLI carry a `User-Agent` of `50heads-mcp/<version>`.
23
- - Nine more tools: `upload_image` (base64 or an https link), `get_answers` (paged and filtered), `add_heads`, `flag_answer`, `export` (CSV, and PDF or PNG as the API adds them), `build_ask_link` (a pre-filled portal link), `list_targeting`, `search_help` and `send_feedback`.
63
+ - **Tools `estimate`, `ask`, `get_results`, `wait_for_results`, `list_questions`, `cancel`, `templates` and `balance`, plus `login`, `status`, `logout` and `config` on the command line.**
64
+ - **The registry manifest `server.json` names `com.50heads/mcp` for the hosted server and the npm package.** Listing that name in the official registry is a separate step from this package.
65
+ - **The Agent Skill is in the package, attached to the GitHub Release, and served at https://50heads.com/skills/50heads.zip.**
66
+ - **Requests from the command send a user agent of `50heads-mcp/<version>`.**
67
+ - **Nine further 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`, `list_targeting`, `search_help` and `send_feedback`.**
68
+
69
+ [2026.1006.1]: https://github.com/50heads/mcp/releases/tag/v2026.1006.1
70
+ [2026.925.2]: https://github.com/50heads/mcp/releases/tag/v2026.925.2
71
+ [2026.925.1]: https://github.com/50heads/mcp/releases/tag/v2026.925.1
24
72
 
73
+ [2026.1009.1]: https://github.com/50heads/mcp/releases/tag/v2026.1009.1
package/README.md CHANGED
@@ -1,6 +1,8 @@
1
1
  # 50heads MCP
2
2
 
3
- 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 900 credits, priced in your account's currency.
3
+ <!-- lead:start (generated from src/pricing.ts by scripts/generate.ts; do not edit by hand) -->
4
+ Ask fifty verified 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 MCP Registry entry, `--version` and the Agent Skill all carry the same number. See [CHANGELOG.md](./CHANGELOG.md).
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
- The package is listed in the official MCP Registry as `com.50heads/mcp` (https://registry.modelcontextprotocol.io/v0/servers?search=com.50heads/mcp), with both the hosted server and this npm package.
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, all from one workflow) is described in [docs/publishing.md](../../docs/publishing.md).
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.