Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Mamiriro (MEGMIS)

by walter-kudzai-kamangaversion 0.1.0i★ 1iComputer or cloudRepository ↗
Registry nameio.github.walter-kudzai-kamanga/megmis

How to install

What it does

PROTOTYPE: Zimbabwe weather, geo, safe routing & journey risk via REST+MCP (stdio/HTTP).

  • Connects Computer or cloud
  • Account or key No key needed
  • Category Travel, maps & weather

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity4/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering8/8The cloud endpoint answered at the last check
Usage score24/100

Quality: Passed 5/5 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Mamiriro (MEGMIS). Follow https://mcp.popnx.com/i/walter-kudzai-kamanga-megmis.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (megmis-api.onrender.com) · ✓ Commands checked Nov 16, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameMamiriro (MEGMIS)
    Remote MCP server URL · Addresshttps://megmis-api.onrender.com/mcp/

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsMamiriro (MEGMIS)

  4. Try it

    Use Mamiriro (MEGMIS) and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Mamiriro (MEGMIS) or shows a Mamiriro (MEGMIS) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameMamiriro (MEGMIS)
    Connection · Addresshttps://megmis-api.onrender.com/mcp/
  3. Pick Mamiriro (MEGMIS) in a chat

    Start a new chat and pick Mamiriro (MEGMIS) from your plugins before typing

  4. Try it

    Use Mamiriro (MEGMIS) and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Mamiriro (MEGMIS) or shows a Mamiriro (MEGMIS) tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user megmis https://megmis-api.onrender.com/mcp/
  3. Type /mcp in Claude Code

    You should see Mamiriro (MEGMIS) listed as connected

  4. Try it

    Use Mamiriro (MEGMIS) and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Mamiriro (MEGMIS) or shows a Mamiriro (MEGMIS) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Mamiriro (MEGMIS) and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Mamiriro (MEGMIS) or shows a Mamiriro (MEGMIS) tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Mamiriro (MEGMIS) and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Mamiriro (MEGMIS) or shows a Mamiriro (MEGMIS) tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://megmis-api.onrender.com/mcp/

JSON settings are under “For developers” below

Stuck? Ask people who use Mamiriro (MEGMIS)💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user megmis https://megmis-api.onrender.com/mcp/

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "megmis": {
      "url": "https://megmis-api.onrender.com/mcp/"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "megmis": {
      "type": "http",
      "url": "https://megmis-api.onrender.com/mcp/"
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user megmis -- uvx megmis

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "megmis": {
      "command": "uvx",
      "args": [
        "megmis"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "megmis": {
      "command": "uvx",
      "args": [
        "megmis"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "megmis": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "megmis"
      ]
    }
  }
}

Values you fill in

  • DEV_API_KEY secret env
    API key for mutating tools / tenant persistence (optional for read-only demos).
  • USE_PERSISTENCE env
    Set false for in-memory local stdio without Postgres/Redis.
  • GEOCODE_PROVIDER env
    Geocoding adapter: mock | nominatim
  • WEATHER_PROVIDER env
    Weather adapter: mock | open-meteo | openweather
  • ROUTING_PROVIDER env
    Routing adapter: mock | osrm | valhalla | graphhopper

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.1.0
Published to registryi
Nov 16, 2026
Code last changedi
Nov 19, 2026
Last checked
Nov 16, 2026
Maker
walter-kudzai-kamanga
Packages
pypi: megmis
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 16, 2026. The maker wrote them, not us; we show them as plain text.

  • get_current_weather

    Current weather for a location ({lat,lon} or {name}).

  • get_forecast

    Daily forecast (1-14 days).

  • get_hourly_forecast

    Hourly forecast for a specific ISO date (YYYY-MM-DD).

  • get_weather_alerts

    Active weather alerts; official warnings labelled separately from model-derived.

  • compare_weather

    Compare current weather across multiple locations.

  • get_historical_weather

    Historical weather observations between ISO dates.

  • get_air_quality

    Air quality index and pollutants for a location.

  • get_agricultural_conditions

    Agricultural / growing-condition indicators.

  • analyze_weather_risk

    Activity-based weather risk (e.g. outdoor_wedding) with recommendations.

  • recommend_outdoor_activities

    Suitability scores for common outdoor activities.

  • geocode

    Geocode an address or place name to coordinates.

  • reverse_geocode

    Reverse-geocode coordinates to an address.

  • find_nearby_places

    Find nearby places by optional category within radius_m.

  • get_emergency_facilities

    Nearby emergency facilities (hospital, police, fire).

  • optimize_route

    Ranked routes with cost_breakdown and explanation (shortest is not always best).

  • create_journey

    Create an active journey from a route_id returned by optimize_route (requires auth).

  • reroute

    Recompute alternatives for an active journey (requires auth).

  • get_route_conditions

    Weather, traffic and road-condition summary for a route or corridor.

  • report_road_condition

    Submit a crowdsourced road-condition report (requires auth + road:write).

  • get_road_incidents

    List road incidents for an area or corridor.

  • assess_journey_risk

    Composite journey risk from weather + routing + road; persists when tenant is known. Tenant resolution order: explicit api_key arg → request ContextVar (X-API-Key on /mcp) → default demo tenant when persistence is on.

  • get_traffic_congestion

    Traffic sub-module congestion estimate for a corridor.

  • list_service_packs

    List Insurance / GovTech commercial service packs (Gen 4).

  • run_service_pack

    Run a commercial pack: insurance.corridor | govtech.emergency | govtech.mobility.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account walter-kudzai-kamanga, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed yesterday

  • ✓ Pass

    Has a licence

    Uses MIT

  • ✓ Pass

    Endpoint responds

    Responded in 134 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 24 tool descriptions and found no hidden instructions to the AI

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for megmis@0.1.0

Checks only this package version, not every dependency · checked Nov 16, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/walter-kudzai-kamanga-megmis.svg)](https://mcp.popnx.com/en/servers/walter-kudzai-kamanga-megmis)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Travel, maps & weatheri

  • More stars than 88% of the other 2052 servers in this category
  • Published to the registry more recently than 87% of the other 2052 servers in this category
  • Basic checks equal to or better than 99% of the other 2052 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Mamiriro (MEGMIS) safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed yesterday, and the latest version (0.1.0) reached the registry 4 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

by microGrowing★ 441Updated 4 months ago

Runs in the cloud✓ micro.mu

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

by WhimsicalCodeEarly★ 11Updated 2 months ago

Runs in the cloud✓ service owner · whimsical.com
Compared with similar ones
This one
Mamiriro (MEGMIS)
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Runs whereCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoYesNoNo
Add with + in ClaudeNoNoNoNoNoYes
Basic checks5/54/43/33/34/44/4
LicenseMITAGPL-3.0MITMITMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Mamiriro (MEGMIS)

Mamiriro Environmental, Geospatial & Mobility Intelligence Server — weather, geospatial, explained routing, road conditions, and journey-risk intelligence for Zimbabwe corridors (and beyond), exposed as REST and MCP (stdio + Streamable HTTP).

Python 3.12 · FastAPI · PostGIS · Redis · official MCP Python SDK

SurfaceEndpoint
REST APIhttp://127.0.0.1:8000/api/v1/...
OpenAPI / docshttp://127.0.0.1:8000/docs
MCP (HTTP)http://127.0.0.1:8000/mcp/
MCP (stdio)megmis-mcp / python -m megmis.mcp_stdio
HealthGET /healthz
Voice Lab (optional)http://127.0.0.1:8000/voice/
Console (optional)http://127.0.0.1:8088/

Status: MIT-licensed public prototype (v0.1.0) — local mocks by default; live providers optional via env. Not a paid SLA or production weather/routing product yet. Listings must say prototype / mock providers.

Naming: Mamiriro is the product; MEGMIS is the project acronym (Environmental, Geospatial & Mobility Intelligence Server); `megmis` is the PyPI / CLI package.

Public surfaceURL
PyPIhttps://pypi.org/project/megmis/
Hosted API / MCPhttps://megmis-api.onrender.com
MCP Streamable HTTPhttps://megmis-api.onrender.com/mcp/
Server cardhttps://megmis-api.onrender.com/.well-known/mcp.json
AI cataloghttps://megmis-api.onrender.com/.well-known/ai-catalog.json

Engineering docs live under docs/.


What it does

  • Weather — current, forecast, hourly, alerts, historical, air quality, ag conditions, activity risk
  • Geo — geocode, reverse geocode, nearby places, emergency facilities
  • Routing — multi-criteria optimize_route with cost breakdown (safest / fastest / …), reroute, corridor conditions, traffic
  • Roads — incident reporting & crowdsourced condition pipeline
  • Risk — journey risk assessment (REST + MCP)
  • Platform — API keys, webhooks (HMAC), tenant RLS, rate limits, worker jobs
  • Voice (Gen 3) — Whisper STT + edge-tts, agent sessions, WebSocket + Voice Lab
  • Commercial (Gen 4) — provider failover, Insurance/GovTech packs, GPS cost calibration, object-store retention, /metrics

Providers are swappable with health-gated failover (mock by default; Open-Meteo / OpenWeather, Valhalla / GraphHopper / OSRM via env). Open-Meteo free API is non-commercial — see OPEN_METEO_COMMERCIAL_OK.


Requirements

  • Python 3.12+
  • Docker (recommended for PostGIS + Redis)
  • Optional: [voice] extras for Whisper / TTS

Install (PyPI / local package)

Once published (or from a built wheel):

pip install megmis

optional voice extras: pip install "megmis[voice]"

stdio MCP for Cursor / Claude / VS Code / Windsurf

USE_PERSISTENCE=false megmis-mcp

or one-shot without a permanent install:

uvx --from megmis megmis-mcp

Build locally without uploading:

pip install -e ".[dev]"

python -m build twine check dist/*

Release to PyPI: push a v* tag after configuring Trusted Publishing (see .github/workflows/release.yml).


Quick start

1. API only (in-memory / no Docker)
python3 -m venv .venv && source .venv/bin/activate

pip install -e ".[dev]" cp .env.example .env

USE_PERSISTENCE=false # optional for offline unit work

uvicorn megmis.main:app --reload --host 0.0.0.0 --port 8000

or: megmis-api

2. Full stack (PostGIS + Redis)

Postgres is published on host 5433 (avoids clashing with a local 5432).

docker compose up --build -d postgres redis

cp .env.example .env

export DATABASE_URL=postgresql+psycopg://megmis:megmis@localhost:5433/megmis export REDIS_URL=redis://localhost:6379/0 export USE_PERSISTENCE=true

alembic upgrade head python scripts/seed.py uvicorn megmis.main:app --reload --port 8000

All-in-one (API + DB + Redis + worker wiring):

docker compose up --build
Dev API keys
X-API-Key: meg_local_devkey00000000000000000001   # demo tenant

X-API-Key: meg_local_tenantb00000000000000000002 # tenant-b (isolation tests)

Auth
  • REST and MCP HTTP: send X-API-Key: meg_… on every request (hashed at rest; scopes enforced).
  • MCP stdio: seeds the demo tenant from DEV_API_KEY / settings (no header needed locally).
  • Mutating MCP tools also accept an api_key argument when no HTTP context is present.
  • OAuth / OIDC for remote connectors is planned for commercial hosting — not required for local stdio.
  • Details: docs/engineering/security-and-tenancy.md.

REST examples

export DEV_API_KEY=meg_local_devkey00000000000000000001

curl -s -H "X-API-Key: $DEV_API_KEY" \ "http://127.0.0.1:8000/api/v1/weather/current?name=Harare" | jq

curl -s -H "X-API-Key: $DEV_API_KEY" -H "Content-Type: application/json" \ -d '{"origin":{"name":"Harare"},"destination":{"name":"Bulawayo"},"profile":"safest"}' \ http://127.0.0.1:8000/api/v1/routes/optimize | jq

Gen 4 commercial pack + provider health

curl -s -H "X-API-Key: $DEV_API_KEY" http://127.0.0.1:8000/api/v1/packs | jq curl -s -H "X-API-Key: $DEV_API_KEY" http://127.0.0.1:8000/api/v1/ops/providers | jq curl -s http://127.0.0.1:8000/metrics | head

Interactive docs: http://127.0.0.1:8000/docs. Contract: docs/api/openapi.yaml (v0.4.0). Gen 4 ops notes: docs/operations/gen4-commercial.md.


MCP

Same tools as REST (weather, geo, routing, roads, journey risk, traffic), plus create_journey. Contracts: docs/api/mcp-tool-contracts.md.

Mutating tools (report_road_condition, create_journey, reroute) require X-API-Key on HTTP /mcp, or an api_key argument. Stdio seeds the demo tenant automatically.

TransportHow
Streamable HTTPhttp://127.0.0.1:8000/mcp/ (same process as the API)
stdiomegmis-mcp or python -m megmis.mcp_stdio
Cursor / Claude Desktop (stdio)

After pip install -e . (or a published megmis wheel), point the client at the console script or module:

{

"mcpServers": { "mamiriro": { "command": "megmis-mcp", "env": { "USE_PERSISTENCE": "false", "DEV_API_KEY": "meg_local_devkey00000000000000000001" } } } }

Editable checkout (absolute venv path):

{

"mcpServers": { "mamiriro": { "command": "/ABS/PATH/TO/.venv/bin/python", "args": ["-m", "megmis.mcp_stdio"], "cwd": "/ABS/PATH/TO/megmis" } } }

VS Code (MCP extension / mcp.json)
{

"servers": { "mamiriro": { "type": "stdio", "command": "megmis-mcp", "env": { "USE_PERSISTENCE": "false", "DEV_API_KEY": "meg_local_devkey00000000000000000001" } } } }

Windsurf

Same stdio shape as Cursor — add under MCP servers:

{

"mcpServers": { "mamiriro": { "command": "megmis-mcp", "env": { "USE_PERSISTENCE": "false", "DEV_API_KEY": "meg_local_devkey00000000000000000001" } } } }

Claude Code

Stdio (after pip install megmis or uvx):

claude mcp add mamiriro --env USE_PERSISTENCE=false -- megmis-mcp

Or remote HTTP (when the CLI supports URL transports):

https://megmis-api.onrender.com/mcp/
Remote / HTTP clients

Local API (uvicorn or Docker):

http://127.0.0.1:8000/mcp/

Hosted prototype (Render):

https://megmis-api.onrender.com/mcp/

Pass X-API-Key the way your client supports custom headers (or use tool api_key on mutating calls). Cursor-style remote entry:

{

"mcpServers": { "mamiriro-http": { "url": "https://megmis-api.onrender.com/mcp/", "headers": { "X-API-Key": "YOUR_RENDER_DEV_API_KEY" } } } }

Local override while developing:

{

"mcpServers": { "mamiriro-http-local": { "url": "http://127.0.0.1:8000/mcp/", "headers": { "X-API-Key": "meg_local_devkey00000000000000000001" } } } }

ChatGPT (Connectors / custom MCP)
  1. Use a ChatGPT plan that supports custom MCP / connectors.
  2. Add a connector pointing at Streamable HTTP: https://megmis-api.onrender.com/mcp/
  3. Send auth as X-API-Key: if the UI exposes custom headers (mutating tools require it).
  4. Label the connector prototype / mock providers until live adapters are the default.

Discovery without a directory: open https://megmis-api.onrender.com/.well-known/mcp.json.

Example prompts
  • Plan the safest Harare → Bulawayo drive and explain the cost breakdown.
  • Assess weather risk for outdoor work in Mutare tomorrow.
  • List road incidents on the Harare–Bulawayo corridor.
  • Assess journey risk from Harare to Bulawayo for a light truck.

Configuration

Copy .env.example → .env. Important knobs:

VariablePurpose
USE_PERSISTENCEtrue → PostGIS + Redis; false → memory fallback
DATABASE_URL / DATABASE_APP_URLOwner vs RLS app role (megmis_app)
USE_APP_ROLEEnforce tenant RLS via app role
WEATHER_PROVIDERmock \open-meteo \openweather
ROUTING_PROVIDERmock \valhalla \graphhopper \osrm
GEOCODE_PROVIDERmock \nominatim
SPEECH_PROVIDER / TTS_PROVIDERwhisper / edge (voice extras)
OSM_EXTRACT_PATHCorridor graph for local Dijkstra

OSM seed extract: data/osm/zimbabwe-harare-bulawayo.osm Optional full country PBF: ./scripts/download_osm_extract.sh


Worker & console

docker compose up -d worker

docker compose --profile console up -d console # http://127.0.0.1:8088/

or locally

megmis-worker # or: python -m megmis.worker python -m megmis.console_app

Worker drains webhooks, validates road reports, fan-outs alerts, and marks OSM graph refresh.


Voice Lab (optional)

pip install -e ".[voice]"

SPEECH_PROVIDER=whisper WHISPER_MODEL=base TTS_PROVIDER=edge

uvicorn megmis.main:app --reload --port 8000

open http://127.0.0.1:8000/voice/

  • STT: OpenAI Whisper via faster-whisper (falls back to mock if deps missing)
  • TTS: edge-tts (ZA English; Shona/Ndebele localized reply text)
  • Scenario: POST /api/v1/agents/scenarios/mutare
  • WebSocket: ws://127.0.0.1:8000/ws/voice/{session_id}?api_key=...

Tests

# unit + contract + BDD + tenant isolation (no Docker)

USE_PERSISTENCE=false pytest -q -m "not integration"

integration (PostGIS + Redis required)

INTEGRATION=1 USE_PERSISTENCE=true pytest -q -m integration

Gen 2 platform + provider HTTP mocks

INTEGRATION=1 USE_PERSISTENCE=true USE_APP_ROLE=true \ pytest -q tests/test_gen2_platform.py tests/test_providers_http.py

deep smokes (API must be running)

python scripts/gen1_deep_smoke.py python scripts/gen2_deep_smoke.py python scripts/gen12_deep_smoke.py

CI: .github/workflows/ci.yml. Strategy: docs/quality/test-strategy.md.


Publish & discovery

Playbook: docs/operations/mcp-publish-and-discover.md

PhaseStatus
0 Pre-flightDone
2 PyPI package + Trusted Publishing workflowDone (upload on first v* tag after PyPI pending publisher)
3 Deploy HTTPS /mcpLive: https://megmis-api.onrender.com (/mcp/)
4 Official MCP Registry (server.json)Manifest ready; publish after PyPI
6+ Directories / GEOAfter registry
Hosted MCP (Phase 3)
# fastest: Render Blueprint (render.yaml) or: fly deploy

then:

./scripts/verify_remote_mcp.sh https://YOURHOST

Set `PUBLIC_BAS

Only the beginning is shown; read the rest in the repo