@50heads/mcp 2026.925.2 → 2026.1006.1

package/server.json

@@ -3,12 +3,11 @@
   "name": "com.50heads/mcp",
   "title": "50heads",
   "description": "Ask fifty verified real people a five-second question and get the split back.",
-  "version": "2026.925.2",
+  "version": "2026.1006.1",
   "websiteUrl": "https://50heads.com/agents",
   "repository": {
     "url": "https://github.com/50heads/mcp",
-    "source": "github",
-    "subfolder": "packages/mcp"
+    "source": "github"
   },
   "icons": [
     {
@@ -45,7 +44,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@50heads/mcp",
-      "version": "2026.925.2",
+      "version": "2026.1006.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"
@@ -78,7 +77,7 @@
           "account:read"
         ]
       },
-      "skillVersion": "2026.925.2"
+      "skillVersion": "2026.1006.1"
     }
   }
 }

package/skills/50heads/SKILL.md

@@ -3,7 +3,7 @@ name: 50heads
 description: Ask fifty verified real people a five-second question and get a distribution back; use when the work in hand needs a human preference, first impression or sanity check that a model cannot supply.
 license: MIT
 metadata:
-  version: "2026.925.2"
+  version: "2026.1006.1"
   homepage: https://50heads.com/agents
 allowed-tools: "50heads:*"
 ---

package/skills/50heads/references/pricing.md

@@ -8,7 +8,7 @@ Per answer = tier base × length × format, plus images and targeting traits, ti
 | --- | --- | --- | --- |
 | 1 | phone-verified | 20 | 1000 |
 | 2 | ID-verified | 42 | 2100 |
-| 3 | trusted panel | 80 | 4000 |
+| 3 | established heads | 80 | 4000 |
 
 Length (question, context and options together): up to 150 characters × 1.0, up to 300 × 1.1, up to 600 × 1.25.
 

package/skills/50heads/references/tools.md

@@ -5,6 +5,7 @@ The core loop is `estimate`, `ask`, then the task (or `wait_for_results`) and `g
 ## Before asking
 
 - `upload_image`: for a local file or a generated image, send it as base64 in `data` (JPEG, PNG or WebP, up to 5 MB; about 700 KB through the hosted server, which takes 1 MB requests). For an image already online, pass `image_url` and 50heads copies it. Use the returned `image_url` in the question. Costs nothing.
+- `list_audiences`: interest audiences, panels of heads who proved they fit (UK commuter cyclists, for example). Put an id in `question.audience` to ask one instead of targeting; the price is the audience's at the minimum grade.
 - `list_targeting`: countries with the languages their heads read and pool size bands, and the tag ids you can target at Tier 2 and 3. Each condition shrinks the pool; `estimate` shows `pool_size`.
 - `build_ask_link`: when a person should press Ask themselves, give them this link. It opens the portal composer with the question filled in and asks nothing. It also opens a template (`template_id`), a follow-up (`follow_up_of`) or a re-ask of the unanswered part (`reask`).
 - `templates` and `list_questions`: a fixed-price template may fit, and a recent answer may already cover the question.
@@ -14,7 +15,7 @@ The core loop is `estimate`, `ask`, then the task (or `wait_for_results`) and `g
 - `get_answers`: individual answers, 50 a page (up to 200), newest first, with `next_cursor`. Filter by `option` (0 is the first), `tier`, `country`, `age_band` or a keyword `q` in written answers and reasons. Country and age filters show nothing when fewer than 5 answers match, so no head can be singled out.
 - `add_heads`: when the margin is under 10 points with 50 heads, ask more of the same question instead of a new one. It needs its own fresh `idempotency_key` and spends at the same price per answer; say the price and time before you do it when a person is present.
 - `flag_answer`: an answer that is off-topic, low effort, offensive or a duplicate, by its `attestation_ref`. Upheld flags remove the answer and refund it. Never flag an answer because you dislike it.
-- `export`: `csv` has every answer (with the same filters as `get_answers`); `pdf` is a one-page report and `png` the result card where the API serves them.
+- `export`: `csv` has every answer (with the same filters as `get_answers`); `pdf` is a one-page report and `png` the result card. The API serves all three.
 - `cancel`: stops a live question and refunds the heads who have not answered.
 
 ## Help
@@ -22,4 +23,4 @@ The core loop is `estimate`, `ask`, then the task (or `wait_for_results`) and `g
 - `search_help`: the help centre, for questions about credits, refunds, verification, tiers, the API or this server.
 - `send_feedback`: tells support about a problem or an idea. Signed out, add `email`. Leave out personal data about other people.
 
-Tools that are new to the API (`add_heads`, `flag_answer`, PDF and PNG `export`) answer `unavailable` until the API serves them. That is not a failure of your call: carry on without them.
+`add_heads`, `flag_answer` and `export` (CSV, PDF and PNG) are served by the API. Use them when the result calls for it.

package/skills/50heads/scripts/estimate.py

@@ -20,6 +20,22 @@ import urllib.request
 API_URL = os.environ.get("FIFTYHEADS_API_URL", "https://api.50heads.com").rstrip("/")
 
 
+def user_agent():
+    """50heads-skill/<version>. Cloudflare answers 1010 to the bare Python-urllib agent."""
+    skill = os.path.join(os.path.dirname(os.path.abspath(__file__)), "..", "SKILL.md")
+    version = "dev"
+    try:
+        with open(skill, encoding="utf-8") as handle:
+            for line in handle:
+                stripped = line.strip()
+                if stripped.startswith("version:"):
+                    version = stripped.split(":", 1)[1].strip().strip("\"'")
+                    break
+    except OSError:
+        pass
+    return "50heads-skill/" + version
+
+
 def to_draft(q):
     """The MCP question object (snake_case) to the API draft (camelCase)."""
     draft = {
@@ -62,7 +78,12 @@ def main():
     source = sys.stdin if sys.argv[1] == "-" else open(sys.argv[1], encoding="utf-8")
     question = json.load(source)
     body = json.dumps({"draft": to_draft(question), "surface": "web"}).encode("utf-8")
-    headers = {"content-type": "application/json", "accept": "application/json", "x-50heads-source": "mcp"}
+    headers = {
+        "content-type": "application/json",
+        "accept": "application/json",
+        "User-Agent": user_agent(),
+        "x-50heads-source": "mcp",
+    }
     key = os.environ.get("FIFTYHEADS_API_KEY")
     if key:
         headers["authorization"] = "Bearer " + key
@@ -71,8 +92,15 @@ def main():
         with urllib.request.urlopen(request, timeout=20) as response:
             quote = json.load(response)
     except urllib.error.HTTPError as err:
-        detail = json.loads(err.read().decode("utf-8") or "{}").get("error", {})
-        print(detail.get("message", "The estimate failed (HTTP %d)." % err.code), file=sys.stderr)
+        raw = err.read().decode("utf-8", "replace")
+        message = "The estimate failed (HTTP %d)." % err.code
+        try:
+            detail = json.loads(raw or "{}").get("error", {})
+            if isinstance(detail, dict) and detail.get("message"):
+                message = detail["message"]
+        except json.JSONDecodeError:
+            pass
+        print(message, file=sys.stderr)
         return 1
     n = question.get("n", 50)
     # The price is in the key's account currency (credits alone when the API sends none).