Skip to content

Releases: cyanheads/stackexchange-mcp-server

v0.1.9: Truncated enrichment gating and accepted-answer completeness

Choose a tag to compare

@cyanheads cyanheads released this 17 Jul 01:29
v0.1.9
bae2fe8

Truncated enrichment gating and accepted-answer completeness

Result-completeness signaling across search_questions, get_tag_faq, and get_thread.

Fixed:

  • truncated enrichment on search_questions, get_tag_faq, and get_thread no longer fires unconditionally — each now gates on genuine capping (SE has_more, or answers.length < answerCount for threads) (#7)
  • get_thread fetches and merges the accepted answer when it ranks outside the top-maxAnswers by votes, and surfaces the question's total answerCount (#11)

136 tests pass; bun run devcheck clean.

CHANGELOG v0.1.9

v0.1.8: search_questions sort/minScore corrections

Choose a tag to compare

@cyanheads cyanheads released this 17 Jul 00:50
v0.1.8
561124a

search_questions sort/minScore corrections

Two related bugs in the sort/min computation for stackexchange_search_questions.

Fixed:

  • sort: "newest" now translates to the creation sort Stack Exchange expects — SE rejected newest directly with bad_parameter (#6)
  • minScore now forces sort=votes, the only score-sorted SE mode, instead of erroring under the default relevance sort or silently filtering by date under activity (#10)

121 tests pass; bun run devcheck clean.

CHANGELOG v0.1.8

v0.1.7: HTML-normalization fixes and mcp-ts-core maintenance

Choose a tag to compare

@cyanheads cyanheads released this 17 Jul 00:21
v0.1.7
24479fc

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.1
  • tsc-alias ^1.8.17 → ^1.9.0
  • @socketsecurity/bun-security-scanner added 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-day minimumReleaseAge install 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.

CHANGELOG v0.1.7

v0.1.6: mcp-ts-core ^0.10.9 maintenance

Choose a tag to compare

@cyanheads cyanheads released this 20 Jun 18:20
v0.1.6
e8b4f09

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.0
  • vitest ^4.1.8 → ^4.1.9

Added:

  • Dependency Specifiers devcheck 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 by devcheck.config.json packaging.pluginManifests (cyanheads/mcp-ts-core#240)

Changed:

  • Fresh-scaffold devcheck guards + check-skill-versions worktree guard (cyanheads/mcp-ts-core#237, #242, #243)
  • api-context skill documents the new ctx.content collector; 13 other skill updates/version bumps
  • .codex-plugin/plugin.json longDescription 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

Choose a tag to compare

@cyanheads cyanheads released this 13 Jun 04:49
v0.1.5
10ba563

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

Choose a tag to compare

@cyanheads cyanheads released this 07 Jun 06:42
v0.1.4
533b791

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, and getTagFaq (#2)
  • Out-of-range integer IDget_thread now throws invalid_id_or_url (not invalid_site) for rejected IDs (#3)
  • authorUserId field — emitted on question and each answer in get_thread; get_user description updated to reference it (#4)
  • Empty-result notice in structuredContentnotice added to enrichment schema for search_questions, get_tag_faq, list_sites (#5)

107 tests pass; bun run devcheck clean.

v0.1.3: Public hosted endpoint

Choose a tag to compare

@cyanheads cyanheads released this 06 Jun 22:15
v0.1.3
f750fa7

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

Choose a tag to compare

@cyanheads cyanheads released this 05 Jun 15:39
v0.1.2
a83c7e6

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:

  • attribution field in the output schema of stackexchange_search_questions and stackexchange_get_tag_faq (structured content channel) (#1)
  • CC BY-SA footer appended by format() on both tools — mirrors the pattern in stackexchange_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

Choose a tag to compare

@cyanheads cyanheads released this 05 Jun 12:37
v0.1.1
d7d2f63

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.