Exposes official government processing times with provenance, history, and comparisons to AI agents.
Also known as artwisdom/govwait, govwait-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.2
- Last commit
- Nov 13, 2026
- License
- Apache-2.0
What is GovWait MCP?
GovWait exposes official government processing times with provenance, history, and comparisons to AI agents.
Summary generated from the project's README
About GovWait MCP server
GovWait provides AI agents with access to a specialized dataset containing official government processing times. It is designed for developers and users who need verified information regarding visa and service wait times, complete with historical context and provenance. The server operates via the Model Context Protocol using stdio, allowing it to be integrated into clients like Claude Desktop or Claude Code through npm or local file paths.
Users can interact with the data using specific tools such as search_entities, get_entity, get_latest_value, and compare_values. The server is unique because every response includes metadata like the source URL, the agency's update date, a verification timestamp, and attribution requirements. If a current source is unavailable, the system provides the last verified value and context rather than presenting outdated information as current. This ensures that agents can distinguish between live data and historical snapshots.
What you can do with it
- 1Compare international visa processing timesAsk an AI to compare how long specific visas take across different countries.
- 2Retrieve specific service metricsRequest current processing day metrics for a specific country's visa service.
- 3Verify data availability and historyCheck the last known waiting time for a service when the official source is no longer accessible.
Written from the project's README. Every use case is checked against a quote from it.
How to install GovWait MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall GovWait MCP in Claude Code
$ claude mcp add govwait -- npx -y govwait-mcpInstall GovWait MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"govwait": {
"command": "npx",
"args": [
"-y",
"govwait-mcp"
]
}
}
}Install GovWait MCP in VS Code
.vscode/mcp.json
{
"servers": {
"govwait": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"govwait-mcp"
]
}
}
}Install GovWait MCP in VS Code CLI
$ code --add-mcp '{"name":"govwait","type":"stdio","command":"npx","args":["-y","govwait-mcp"]}'Install GovWait MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"govwait": {
"command": "npx",
"args": [
"-y",
"govwait-mcp"
]
}
}
}Install GovWait MCP in Codex
$ codex mcp add govwait -- npx -y govwait-mcpInstall GovWait MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.govwait] command = "npx" args = ["-y", "govwait-mcp"]
Install GovWait MCP in Gemini CLI
$ gemini mcp add -s user govwait npx -- -y govwait-mcpInstall GovWait MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"govwait": {
"command": "npx",
"args": [
"-y",
"govwait-mcp"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachableartwisdom/govwait is public and reachablegithub.com/artwisdom/govwait ↗Pass
- Package names this repository as its sourcegovwait-mcp names artwisdom/govwait as sourcenpmjs.com/package/govwait-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/artwisdom/govwait ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from govwait-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubGovWait MCP Server
Exposes the GovWait dataset (officially published government processing times, with provenance and history) to AI agents over the Model Context Protocol (stdio).
Tools: search_entities, get_entity, get_latest_value, compare_values.
Every response carries source_url, the agency's own update date when supplied
(otherwise GovWait's first-observed date), our verification timestamp, source
collection status, the source unit, and the attribution requirement. When a source
is unavailable, current_value and value_days are null; its retained value is
returned only as last_verified_value with value_context set to
last_verified_source_snapshot.
Install from npm
Run the current public package directly:
npx -y govwait-mcp
For Claude Code, register that same public package with:
claude mcp add --scope user govwait-mcp -- npx -y govwait-mcp
Build and verify the source locally
cd machine/mcp-server
npm ci
npm run verify
To retain a normal data-bearing release candidate and its SHA-256 sidecar in the
git-ignored release/ directory, run npm run prepare:rc. For a
documentation-only candidate that must preserve the existing bundled data
byte-for-byte, run npm run prepare:docs-rc instead.
npm run build copies the three validated pipeline exports into this package's
own data/ directory, writes deterministic SHA-256 provenance metadata, and
compiles dist/index.js. The server defaults to those package-owned files, so it
does not depend on the parent repository at runtime. Advanced local users can
still override the location with GOVWAIT_DATA_DIR=/path/to/exports; that
directory must contain the three exports. A matching provenance.json is used
when present; the package-owned default always requires it.
npm run audit:package creates a tarball in a temporary directory, enforces the
exact nine-file package allow-list, rejects secret/database/cache/log/source/test
artifacts, verifies every bundled data hash, unpacks the tarball into a clean
temporary project with the already-locked npm ci dependency tree, and runs the
complete MCP smoke test against that isolated copy. The temporary package is
deleted afterward; no registry access is needed.
The verified public baseline is
govwait-mcp@0.1.1, and its
mcpName exactly matches io.github.artwisdom/govwait in the official MCP
Registry metadata. It was published to npm and accepted as active in the official
MCP Registry. Version 0.1.1 uses a SEE LICENSE IN LICENSE field that
points to Apache 2.0 terms limited to GovWait-owned software code.
DATA-NOTICE.md and the licence scope expressly exclude the bundled
government-source data. A clean public-registry installation passed the full MCP
smoke suite. npm publishing requires interactive 2FA and disallows
automation/bypass tokens. Official mcp-publisher 1.8.1 validates server.json,
and the
official Registry listing for 0.1.1
records that release; use npm's latest tag and the Registry's latest endpoint
for the current public version rather than treating a local build as proof.
Version 0.1.2 changes package documentation and release metadata only. It
preserves the exact bundled dataset and four MCP tool behaviors verified for
0.1.1, while adding the public install command above and removing stale
pre-publication wording. Building or verifying the package remains a local
action and does not publish another npm or Registry version.
Register a local checkout with Claude Code
claude mcp add govwait -- node /ABSOLUTE/PATH/TO/govwait/machine/mcp-server/dist/index.js
Register a local checkout with Claude Desktop
Add to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"govwait": {
"command": "node",
"args": ["/ABSOLUTE/PATH/TO/govwait/machine/mcp-server/dist/index.js"]
}
}
}
Try it
Ask the connected agent: "How long is a Canada visitor visa taking from India right
now, and how does that compare to Nigeria and the Philippines?" — it should call
compare_values and answer with dated, sourced figures.
For New Zealand, try "What are the current Visitor Visa processing times?" The
nz-visitor-visa service returns both INZ's 50% and 80% working-day metrics.
For Norway, try "What was UDI's last verified visitor-visa waiting time, and is
the source still available to GovWait?" The server returns the dated,
table-backed snapshot, its official source page, and the source_unavailable
state without presenting that snapshot as current.
Data provenance and reuse
Every response retains the official source URL, source date, verification time,
unit, and GovWait attribution notice. data/provenance.json records the exact
dataset generation time, row counts, byte sizes, and SHA-256 hashes. Underlying
government information is not relicensed by GovWait; follow the source-specific
terms at https://govwait.com/data-license/ and the packaged
DATA-NOTICE.md.
Distribution
The local
server.json
is valid MCP Registry metadata for the public npm package. Registry and other
directory submissions remain separate owner actions in the
distribution checklist.
GovWait MCP questions
How do I add GovWait MCP to Claude Code?
Run claude mcp add govwait -- npx -y govwait-mcp in your terminal. Add --scope user to make it available in every project.
How do I add GovWait MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What information is included in the processing time responses?
Every response includes the source URL, the agency's update date, a verification timestamp, source collection status, the source unit, and attribution requirements.
How does the server handle unavailable sources?
If a source is unavailable, the current value and value days are returned as null, and the system provides the last verified value with a specific context.
Can I use a custom data directory?
Yes, advanced users can override the default data location using the GOVWAIT_DATA_DIR environment variable.