Open Market Research MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Open Market Research MCP Plan market research for a case management system and suggest sources"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Open Market Research MCP
An open-source, evidence-first market research companion for digital government acquisition and the DITAP curriculum.
Version: 0.2.0, educational starter. Not affiliated with or endorsed by USDS, GSA, CMS, DITAP, or 1102tools.
Start here
Open the published GitHub Pages site. You do not need an account, installation, API key, or AI subscription.
Start new research asks for the problem, the product or service type, the agency context, and whether you prefer guided, manual, or approved-AI-assisted work.
Continue existing research opens a saved JSON file.
Try a fictional DITAP example loads the teaching case.
The browser workspace is static. Save a research file to resume after closing the browser; nothing is uploaded automatically. Use AI help to generate a prompt for an approved agency assistant, or open the About page for optional local MCP and local-LLM setup. None of these is required.
The practical objective is to help an acquisition professional answer:
What problem are we trying to solve, and for whom?
Could we reuse government software or existing open source before buying or building?
What comparable commercial and government solutions are available?
What accessibility requirements and product-specific evidence apply?
What questions and verifications are still needed?
How do we document sources, uncertainties, and agency approval points?
Related MCP server: GateCore
What works today
Zero-install GitHub Pages app: A plain-language landing page, simplified starting questions, source guidance, an approved-AI prompt assistant, and the seven-stage research workflow. Save or reopen a human-readable JSON file, use source cards to prefill a not-searched search form, and export JSON or a Markdown draft. No account or installation.
Approved-AI prompt assistant: Generate, preview, and copy prompts for Plan my research, Review my evidence, and Draft my report. The page does not call a model. Prompts are built from the current record and require human verification.
AI-use disclosure: Optionally record the approved tool, actions, and what a person verified; the report includes it only when AI use is explicitly marked.
Optional technical About page: Local MCP and local-LLM setup are separated from the primary research task.
Evidence-backed research record (0.2.0): Research questions, searches, evidence, findings, and pending decisions are linked by stable identifiers. Legacy 0.1.0 records import through a documented migration that does not invent history.
Static About the local MCP and AI guidance: The About page explains the local stdio server, its tools/resources, and its boundaries without claiming live MCP data, and provides copyable AI prompt patterns that do not execute a model.
Shared decision rules:
src/omr_mcp/rules.jsondrives the browser and Python questions, validation limits, and report wording from one versioned source.Optional remote MCP starter: A separate Cloudflare Worker under
remote-mcp/exposes 5 public read-only reference/planning tools.PUBLIC_MCP_ENABLEDis false by default; it is not deployed. See remote MCP deployment boundaries.Local MCP server: Eight read-only/deterministic tools and two resources for source discovery, research planning, accessibility evidence questions, report drafting, public metadata normalization, OpenACR import, and fixture-based USAspending record mapping.
Public metadata adapters: Read-only normalization of public
code.json,agency-index.json, andpubliccode.ymlwith source, retrieval date, data-as-of date, license, access rights, and limitations.OpenACR import prototype: Local CLI and MCP import of OpenACR YAML for human review, checked against the pinned upstream schema and optionally compared with a catalog for missing criteria. It distinguishes supports, partial support, non-support, not applicable, not evaluated, and missing claims, and does not create or certify an ACR.
DITAP workshop materials: Expanded fictional case with a reuse conflict, open-source and commercial options, a partial ACR, missing ACRs, a no-result search, a failed search, and open decisions; facilitator guide, worksheet, rubric, pilot protocol, and sample evidence-backed report. These are prepared but not yet learner-tested.
GitHub Actions: Tests Python, Node, MCP-over-stdio, browser behavior, axe/keyboard regressions, and the upstream OpenACR CLI; publishes the static app and can refresh an allowlisted public
code.jsonsample as a reviewable artifact.DITAP fixture: Clearly fictional case management scenario, never a real vendor shortlist.
Optional 1102tools/USAspending mapping demo: A selected public award record can be mapped to a search/evidence draft and applied to a local research file only with
--approve. No live integration or copied 1102tools code. See the applied sample report.Optional Hugging Face Action: Manual run on the fictional fixture, publishes an unverified artifact for review, never into the website.
No live procurement, vendor, ACR, ART, CMS, or AI APIs are connected by the browser. The source directory and public software sample are curated static metadata and links, not a comprehensive or live market search. A scheduled GitHub Action can refresh the public sample for review; it does not publish it automatically. OpenACR and public metadata are parsed only by local tools, not by the static site. The app never determines Section 508 conformance or approves exceptions.
Accessibility status: automated axe scans, keyboard/focus regression tests, 320 CSS px reflow, and forced-colors focus checks run in CI. Manual screen-reader testing with NVDA, JAWS, and VoiceOver has not been performed, and no WCAG conformance claim is made. The manual evidence pack provides the environments, tasks, issue record, and results template for a real audit. See testing.
Deploy to GitHub Pages
Create an empty GitHub repository named
open-market-research-mcpor another name of your choice. Usemainas the default branch.Copy all files and hidden directories from this starter into the repository. Keep
.github/workflows/pages.yml.Commit and push to
main.Open Settings > Pages > Build and deployment > Source > GitHub Actions.
Open Actions > Test and deploy GitHub Pages and check the result. You can also run the workflow manually.
Visit the published project URL, typically
https://YOUR-USER.github.io/YOUR-REPO/.
The deployment uses only relative URLs, so the repository name is not hard-coded.
Run locally
Interpreter note: commands in this README use python. If your local interpreter is python3, substitute python3 (and python3 -m pip) throughout. CI uses the interpreter installed by actions/setup-python.
Static app
python scripts/build_site.py
python -m http.server 8000 --directory _siteOpen http://localhost:8000. Opening the source HTML with file:// will not load the JSON because browser security blocks local fetches.
Python MCP server for an AI client
Requires Python 3.11+, network access to install packages, and an MCP-compatible client.
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -e .
omr-mcpAn MCP client's stdio configuration should point to the absolute path of the virtual environment executable. For example:
{
"mcpServers": {
"open-market-research": {
"command": "/absolute/path/to/repo/.venv/bin/omr-mcp"
}
}
}The server uses the official MCP Python SDK v2 API. Its tool code is testable without a running model. It does not call 1102tools automatically. Use a client that connects both MCP servers, or add a future adapter with clear provenance.
For host-specific setup with LM Studio, Jan, or mcphost + Ollama, see Connect the local MCP server to a local LLM. That guide also covers the no-MCP option of copying the static prompts and exported records.
Run tests
pip install -e '.[dev]'
python -m pytest -q
node --test tests/research.test.mjs
python scripts/build_site.py
npm ci
npx playwright install chromium
npm testnpm test runs the Node unit tests, the pinned upstream OpenACR CLI
validation, and the Playwright/axe browser suite. Node 22 is used by CI. The
static site has no runtime npm dependencies; Playwright and the OpenACR CLI
are dev-only test tooling recorded in package-lock.json.
Architecture: static Pages plus local MCP
GitHub repository
(one canonical catalog)
|
+----------------+----------------+
| |
GitHub Actions Python MCP v2
validate and build local / stdio server
| |
GitHub Pages MCP-capable AI
no server, no keys assistant or client
|
browser-only research notes
import/export JSON, MarkdownGitHub Pages cannot host a live MCP HTTP endpoint or securely store AI API secrets. GitHub Actions run jobs and generate deployable files, not a continuously listening server. Hosted MCP would require a serverless/always-on runtime such as Cloudflare Workers, a container, or an approved agency host. See Architecture.
src/omr_mcp/rules.json is copied to the Pages build and loaded by the browser; the Python server reads the same file. Public metadata normalization and OpenACR import are local-only tools, not browser features and not live API calls.
Optional Hugging Face AI
AI is intentionally not needed for searching the static catalog, detecting missing evidence, or building draft reports. Do not put HF_TOKEN in JavaScript, repository files, client-side environment variables, or GitHub Pages artifacts.
If wanted, set repository secret HF_TOKEN with a fine-grained Hugging Face token granting Inference Providers calls. In GitHub Actions, manually dispatch Optional HF fictional demo and enter a provider-supported model identifier. The result is a downloadable workflow artifact, not an automatically published research finding. The Action sends only the explicitly fictional, public scenario, never real procurement content. Hosting AI for real records needs agency authorization, redaction, budget limits, and a separate security review.
See AI decision record. The optional weekly Reviewable public code.json snapshot workflow also downloads an allowlisted, public-only CMS metadata sample as an artifact; review and commit the JSON file to change the live site.
Sources and standards to reuse
These links are reference sources, not claims that any external program endorses this project.
What to build next
See Phase 1 assessment, Phase 2 assessment, procurement usability test plan, Roadmap, research schema, migration, DITAP alignment, workshop materials, decision rules, public metadata adapters, OpenACR import, 1102tools integration proposal, remote MCP deployment, implementation agent prompt, security, and contributing.
License
MIT for this starter's original code and writing. Upstream standards, records, trademarks, and external materials retain their own terms. No external source documents or ACRs are republished in this starter.
Available Tools
8 toolscreate_research_planC
Give a DITAP-compatible human-centered market research sequence.
Inputs: no named parameters. Returns: result
draft_market_research_reportB
Render a local research record into an unapproved Markdown draft.
Inputs: research_json (required). Returns: result
find_research_sourcesC
Find relevant source directories, guidance, and upstream MCP servers.
Inputs: query (required). Returns: result
identify_accessibility_evidence_gapsB
List verification questions for one candidate, without deciding conformance.
Inputs: candidate_json (required). Returns: result
import_openacr_reportB
Import OpenACR YAML for inspection. Never creates or certifies an ACR.
Inputs: openacr_yaml (required), catalog_yaml.
list_research_sourcesC
List curated source descriptors. This does NOT query live government APIs.
Inputs: category. Returns: result
map_1102tools_usaspending_recordB
Map one selected public USAspending record into a reviewable evidence draft.
This makes no network request and does not apply the record to a research file. The host must obtain explicit human approval before applying it.
Inputs: question_id (required), record_json (required), retrieved_at (required), source_url, +1 more.
normalize_public_metadataB
Normalize local code.json, agency-index.json, or publiccode.yml text.
This performs no network request and does not treat metadata as proof of suitability, reuse rights, or accessibility conformance.
Inputs: metadata_text (required), metadata_format (required), repository, source_url.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Most tools occupy clearly distinct stages of a market-research workflow (plan, source discovery, gap analysis, drafting, metadata import/mapping). The only genuinely adjacent pair is list_research_sources vs find_research_sources, whose boundary (curated descriptors vs directories/guidance/upstream servers) is stated but still easy to confuse. The remaining six tools are unambiguous.
Every tool follows a snake_case verb_noun pattern (list_, find_, create_, identify_, draft_, normalize_, import_, map_), with no camelCase or bare-noun outliers. The one long name, map_1102tools_usaspending_record, embeds product nouns but still conforms to the same verb-first convention.
Eight tools is a good scope for a niche research pipeline, with each mapping to a discrete step rather than duplicating work. A couple of tools (import_openacr_report, normalize_public_metadata) are narrow single-format utilities, which slightly inflates the surface relative to the broader planning tools.
The set covers discovery, planning, gap analysis, and output rendering, but there is no tool to persist a research record, candidate, or evidence artifact—several tools explicitly defer application to the host, leaving dead ends for an agent working end-to-end. There is also no update/edit or retrieval-by-id operation for existing records, only rendering of 'a local research record' assumed to already exist.
Maintenance
Related MCP Connectors
AgencyAI's public MCP for service discovery and AI-readiness assessment.
MCP access to the U.S. federal procurement graph: contracts, opportunities, entities, and more.
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
Federal+SLED govcon MCP: SAM, USASpending, recompete, hearings, policy intel, search. Private AI.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceEnables MCP clients to search and retrieve contract intelligence over public contract data, with agent skills for precedent lookup, negotiation checks, and risk flagging, all with verification and citations.-

GateCoreofficial
AlicenseNot gradedqualityCmaintenanceEnables AI agents to discover governed capabilities, inspect machine-readable contracts, and request policy-checked procurements with signed receipts and audit trails.Apache 2.0- AlicenseNot gradedqualityBmaintenanceEnables procurement officers and MCP clients to ingest tender and bid documents, run cited multi-agent evaluations with scores and risk flags, and review audit trails while preventing AI from recording award decisions.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search and retrieve stored open-source information through read-only MCP tools, including evidence retrieval by document or snapshot ID with byte-integrity verification.1Apache 2.0