Maldives Gazette MCP

A portable, read-only Model Context Protocol server for the official Maldives Government Gazette:

https://www.gazette.gov.mv/gazette

It is agent-agnostic: every MCP-compatible client launches the same TypeScript/Node.js stdio server. No Python, virtualenv, account, cookie, API key, or hosted service is required.

What it exposes

The server allowlists Gazette record pages, official Gazette Storage attachments, and official CSC /download/ attachments. It never logs in, posts, edits, contacts anyone, or changes the source site.

Related MCP server: mozaia-laws-mcp

Install

Node.js 20+ is required.

git clone https://github.com/Rayyan011/maldives-gazette-mcp.git
cd maldives-gazette-mcp
npm install
npm run build

The portable MCP command is:

node /absolute/path/to/maldives-gazette-mcp/dist/server.js

Verify

Run the real Node MCP protocol test:

npm run test:protocol

Client setup

All examples below use:

• NODE: /absolute/path/to/node

• SERVER: /absolute/path/to/maldives-gazette-mcp/dist/server.js

Claude Code

claude mcp add maldives-gazette -- NODE SERVER

Or project .mcp.json:

{
  "mcpServers": {
    "maldives-gazette": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/maldives-gazette-mcp/dist/server.js"]
    }
  }
}

Codex CLI

codex mcp add maldives-gazette -- NODE SERVER

Or add the equivalent stdio server to Codex's MCP configuration using the JSON shape shown above.

Cursor

Add this to Cursor's MCP settings or .cursor/mcp.json:

{
  "mcpServers": {
    "maldives-gazette": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/maldives-gazette-mcp/dist/server.js"]
    }
  }
}

Claude Desktop

Add the same mcpServers entry to Claude Desktop's claude_desktop_config.json.

Gemini CLI

Register the same command as a local stdio MCP server in Gemini CLI's MCP settings. The server name should be maldives-gazette.

Windsurf

Add the same JSON entry to Windsurf's MCP configuration (mcp_config.json).

Cline / Roo Code

Use the MCP settings UI and add a stdio server:

• Name: maldives-gazette

• Command: NODE

• Arguments: SERVER

VS Code MCP

Add the equivalent mcp server entry in the workspace or user MCP configuration, using the same command and args.

Goose / Continue / other clients

Choose stdio/local MCP server and use:

command: NODE
args: SERVER

The MCP protocol is the compatibility layer; no client-specific code is inside this repository.

Hermes Agent

printf 'y\n' | hermes mcp add maldives-gazette \
  --command NODE \
  --connect-timeout 30 \
  --args SERVER
hermes mcp test maldives-gazette

Usage examples

Read the homepage's newest official records:

Use latest_homepage_feed with source="all" and max_results=10.

Crawl a bounded archive safely:

Use crawl_iulaan_archive with announcement_type="masakkaiy", from_page=1, max_pages=10, max_results=200.

Search the latest regulations:

Use search_gazette with category="gavaaidhu" and max_results=10.

Search by a record number or Dhivehi phrase:

Use search_gazette with query="66-އާރ/2026".

Read one record:

Use get_gazette with url_or_id="7539".

For legal or policy research, treat the linked official PDF as the authoritative document. A Gazette title alone does not establish current validity, repeal status, or legal effect.

Included skills

The repository also includes portable, agent-agnostic skills under skills/:

• gazette-business-project-finding — discover, verify, and compare public tenders, bids, supplies, and project opportunities.

• gazette-government-job-finding — find, verify, and compare government job announcements from Iulaan.

• gazette-compensation-calculator — calculate transparent monthly salary estimates from fixed and attendance-based allowances.

• gazette-dhivehi-query-builder — turn English research requests into standard Dhivehi Thaana search variants.

• gazette-job-shortlist-ranking — rank job postings against a candidate's qualifications and preferences.

• gazette-deadline-monitor — re-check saved Iulaan postings and classify deadline risk.

• gazette-tor-evidence-extraction — download and read official TORs and application documents, including English TORs.

• gazette-mcp-client-setup — install and configure the TypeScript MCP in compatible clients.

• gazette-pdf-research — search and cite evidence inside official Gazette and Iulaan PDFs.

• gazette-filtered-search — use the website's live category, office, date, job, and open-status filters.

These are plain SKILL.md files and can be copied into Hermes, Claude Code, Codex, Cursor, or another agent's skill directory. They use the same MCP but remain separate workflows.

Repository guidance

See AGENTS.md for setup, safety boundaries, testing requirements, and contribution rules.

License

MIT