Releases: cyanheads/stackexchange-mcp-server
Release list
v0.1.9: Truncated enrichment gating and accepted-answer completeness
Truncated enrichment gating and accepted-answer completeness
Result-completeness signaling across search_questions, get_tag_faq, and get_thread.
Fixed:
truncatedenrichment onsearch_questions,get_tag_faq, andget_threadno longer fires unconditionally — each now gates on genuine capping (SEhas_more, oranswers.length < answerCountfor threads) (#7)get_threadfetches and merges the accepted answer when it ranks outside the top-maxAnswersby votes, and surfaces the question's totalanswerCount(#11)
136 tests pass; bun run devcheck clean.
v0.1.8: search_questions sort/minScore corrections
search_questions sort/minScore corrections
Two related bugs in the sort/min computation for stackexchange_search_questions.
Fixed:
sort: "newest"now translates to thecreationsort Stack Exchange expects — SE rejectednewestdirectly withbad_parameter(#6)minScorenow forcessort=votes, the only score-sorted SE mode, instead of erroring under the defaultrelevancesort or silently filtering by date underactivity(#10)
121 tests pass; bun run devcheck clean.
v0.1.7: HTML-normalization fixes and mcp-ts-core maintenance
HTML-normalization fixes and mcp-ts-core maintenance
Three html-normalizer/service findings patched, plus framework and supply-chain maintenance.
Dependency bumps:
@cyanheads/mcp-ts-core^0.10.9 → ^0.10.14@biomejs/biome^2.5.0 → 2.5.2@types/node^26.0.0 → 26.1.1tsc-alias^1.8.17 → ^1.9.0@socketsecurity/bun-security-scanneradded at ^1.1.2
Fixed:
- Non-BMP HTML entity decoding (emoji, rare CJK) via
String.fromCodePoint, guarded against out-of-range code points (#8) - SE code-block language captured from the
<pre>class, not<code>(#9) - Author display names and location decoded through
decodeHtmlEntities(#12)
Changed:
- Supply-chain hardening — Socket
bun-security-scanner+ 3-dayminimumReleaseAgeinstall gate (framework dep excluded) - Docker base image pinned to
oven/bun:1.3.14; BuildKit cache mounts on install layers - New
.gitattributes,.github/FUNDING.yml,.github/SECURITY.md
115 tests pass; bun run devcheck clean.
v0.1.6: mcp-ts-core ^0.10.9 maintenance
mcp-ts-core ^0.10.9 maintenance
Framework-maintenance release — synced scripts, skills, and devcheck config from mcp-ts-core 0.10.7–0.10.9. No server source or behavior changes.
Dependency bumps:
@cyanheads/mcp-ts-core^0.10.6 → ^0.10.9@types/node^25.9.3 → ^26.0.0vitest^4.1.8 → ^4.1.9
Added:
Dependency Specifiersdevcheck step (check-dependency-specifiers.ts) — rejects floating specifiers in package.json + bun.lock workspaces (cyanheads/mcp-ts-core#246)- Plugin marketplace manifest checks in
lint:packaging, gated bydevcheck.config.jsonpackaging.pluginManifests(cyanheads/mcp-ts-core#240)
Changed:
- Fresh-scaffold devcheck guards +
check-skill-versionsworktree guard (cyanheads/mcp-ts-core#237, #242, #243) api-contextskill documents the newctx.contentcollector; 13 other skill updates/version bumps.codex-plugin/plugin.jsonlongDescription expanded to the full network description
107 tests pass; bun run devcheck clean.
v0.1.5: mcp-ts-core 0.10.6 adoption, bundle hygiene, plugin metadata
mcp-ts-core 0.10.6 adoption, bundle hygiene, plugin metadata
Maintenance release: framework upgrade to @cyanheads/mcp-ts-core ^0.10.6 with truncation enrichment and validationError reclassification, MCPB bundle cleaning, and populated plugin manifests.
Added:
- Truncation enrichment (truncated/shown/cap) on search_questions, get_thread, get_tag_faq via ctx.enrich.truncated()
- scripts/clean-mcpb.ts — strips dependency-shipped agent-doc trees from the bundle (wired into the bundle script)
- Dockerfile /healthz HEALTHCHECK and APP_VERSION OCI label
- techniques skill (outline-on-overflow reference)
Changed:
- createApp() sets explicit name/title identity
- invalid_site / invalid_id_or_url reclassified InvalidParams → ValidationError
- .mcpbignore dev-dir patterns root-anchored
- Plugin manifests (.claude-plugin, .codex-plugin) populated with author/homepage/repository/description
Dependency bumps:
- @cyanheads/mcp-ts-core ^0.9.21 → ^0.10.6
- @biomejs/biome ^2.4.16 → ^2.5.0
- @types/node ^25.9.2 → ^25.9.3
107 tests pass; bun run devcheck clean.
v0.1.4: DX fixes: HTML entity decoding, ID error classification, authorUserId field, empty-result notices
DX fixes: HTML entity decoding, ID error classification, authorUserId field, empty-result notices
Four field-test findings patched across the tool surface.
Fixed:
- HTML entity decoding — question titles and excerpts decoded before returning in
searchQuestions,getThread, andgetTagFaq(#2) - Out-of-range integer ID —
get_threadnow throwsinvalid_id_or_url(notinvalid_site) for rejected IDs (#3) authorUserIdfield — emitted on question and each answer inget_thread;get_userdescription updated to reference it (#4)- Empty-result
noticeinstructuredContent—noticeadded to enrichment schema forsearch_questions,get_tag_faq,list_sites(#5)
107 tests pass; bun run devcheck clean.
v0.1.3: Public hosted endpoint
Public hosted endpoint
Registers https://stackexchange.caseyjhand.com/mcp as the public Streamable HTTP endpoint.
Added:
- server.json remotes[] entry (streamable-http, stackexchange.caseyjhand.com/mcp)
- README: Public Hosted Server link block + Public Hosted Instance section with client config
Changed:
- @types/node ^25.9.1 → ^25.9.2
bun run devcheck clean; bun run rebuild succeeds.
v0.1.2: CC BY-SA attribution on search and FAQ output
CC BY-SA attribution on search and FAQ output
Stack Exchange content is licensed CC BY-SA 4.0 and requires attribution. This release surfaces the license notice in both output channels for the two tools that were missing it.
Added:
attributionfield in theoutputschema ofstackexchange_search_questionsandstackexchange_get_tag_faq(structured content channel) (#1)- CC BY-SA footer appended by
format()on both tools — mirrors the pattern instackexchange_get_thread(#1) - Tests for attribution in handler output and
format()output on both tools
99 tests pass; bun run devcheck clean.
v0.1.1: Initial public release — 5 Stack Exchange tools
Initial public release — 5 Stack Exchange tools
First public release of @cyanheads/stackexchange-mcp-server. Provides question search, full Q&A thread fetch (markdown with code blocks), tag FAQ lookup, user profile lookup, and site enumeration over the Stack Exchange API v2.3. Keyless by default; STACKEXCHANGE_API_KEY lifts quota to 10k/day.
Added:
- stackexchange_search_questions — full-text search with tag/sort/date filters
- stackexchange_get_thread — complete Q&A thread as clean markdown, code blocks preserved
- stackexchange_get_tag_faq — most frequently-linked questions for a tag
- stackexchange_get_user — reputation, badge counts, top tags by answer score
- stackexchange_list_sites — enumerate all ~190 Stack Exchange network sites
Security:
- Error payloads no longer include upstream response bodies; only HTTP status codes surface in serviceUnavailable errors
96 tests pass; bun run devcheck clean.