#47 · Add `bcw_search` tool to find BCTs by free-text description
Last checked with GitLab: . Status comes from GitLab using a 2-minute cache. Merge events clear affected cached statuses. An already-open page does not update itself. Refresh page.
An MR completes this bounty when it is merged into main with Closes #47 and GitLab closes the issue. A mention or an updated timestamp is not completion. Awarded points appear in Activity.
cp .dev.vars.example .dev.vars && pnpm dev, after rebasing on main) and fully test your change before opening the MR.
Description
Context
Today the BCW MCP exposes the canon and recommendations but a user has to know which BCT they want. A simple text-search tool over BCT names and descriptions makes the canon discoverable.
Acceptance criteria
- [ ]
bcw_search(query: string, limit?: number=10)returns matching BCTs sorted by relevance - [ ] Search is case-insensitive substring match across name + short_description
- [ ] Results include BCT id, group, and a one-line description
Technical hints
- Canon already loaded in memory — search is just an array filter
Scope update (2026-10-04, owner-approved — see note on this issue)
- The hint above is out of date: bcw-mcp has no in-memory canon. It wraps the ResearchTools
/api/frameworks/comb-analysis/canonendpoint, which today returns BCT IDs and groupings only. - Step 1 (researchtoolspy MR): move
BCT_TAXONOMYintosrc/lib/bcw-canon.tsand add abcts: [{id, group, group_name, label}]array to/canon. - Step 2 (this repo,
Closes #47):bcw_searchfetches and caches/canon, then does a case-insensitive substring match over label + group name. Results include id, group and label. short_descriptionmatching is deferred until the BCTTv1 definitions are cleared for reproduction. Don't bundle a copy of the taxonomy in bcw-mcp.
--- *Submit a merge request that says Closes #<this issue iid> in the description. On merge to main, the GitLab webhook will auto-award your bounty + the standard merge_pr (40 pts) to your scoreboard account. Email on commit must match your Authentik email.*
Relevant files
No relevant files linked yet.
Hints
No hints yet.
Activity
No points have been awarded for this bounty yet.
Comments (1)
Sign in to join the discussion.
Where is the approved complete BCTTv1 dataset, and may we bundle a versioned copy in bcw-mcp? The current canon API supplies IDs/groupings but no names or descriptions.