Uganda Online Business Directory
Search a Ugandan business directory for businesses and services by keyword, category, or district
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http uganda-online-business-directory 'https://ug-online.domus-dei-tech.workers.dev/mcp'
{
"mcpServers": {
"uganda-online-business-directory": {
"type": "http",
"url": "https://ug-online.domus-dei-tech.workers.dev/mcp"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Muyiribi
Business directory for Uganda. Cloudflare Worker + Neon Postgres, with a simple web UI and an MCP endpoint for AI tools.
Routes
/landing page/searchpublic business search by keyword, category, and district/signup,/login,/logoutphone + password accounts (password show/hide toggle)/dashboardmanage the signed-in account's business listings and plan capacity/addadd a business listing (creation limit depends on tier; description min 40 characters)/listings/:id/editsecurely edit a listing owned by the signed-in account/mcpMCP endpoint with tools:search_businesses,get_business,list_categories
Results are ranked by tier, highest first (black, green, blue, free).
Setup
- Run
schema.sqlonce in the Neon SQL console. - Install dependencies:
npm install - Set the database secret:
npx wrangler secret put DATABASE_URL(your Neon connection string) - Local dev:
npm run dev - Deploy:
npm run deploy
Your MCP URL is: https://ug-online.domus-dei-tech.workers.dev/mcp.
Notes
- Passwords are hashed with PBKDF2 (Web Crypto). Accounts lock for 15 minutes after 5 failed logins.
- Creation limit (how many listings an account can create): Free 3, Basic 5, Pro 7, Premium unlimited.
- Search limit (how many of an account's listings can appear in search): Free 1, Basic 3, Pro 5, Premium unlimited. Newest first.
- Results are ordered by tier, highest first.
- Paid tiers only count while an active subscription exists. No flow creates subscriptions yet; payments come later.
/pricingshows all tiers and sells them via PesaPal. Every paid tier (Basic UGX 5,000/yr, Pro UGX 12,000/yr, Premium UGX 25,000/yr) requires business contact phone verification by SMS OTP (sent via UgaText) before the tier is granted. Seemigrations/002_verification.sqlandmigrations/003_tier_names_and_pricing.sql, andmigrations/004_payment_phone_optional.sql.- Paid-tier flow is one page. "Get <tier>" creates a PesaPal order and shows its checkout in an
iframe on
/pricing/status. The page polls/pricing/checkuntil payment completes, then asks for the verification number (prefilled, editable) and sends the SMS code. Status is only trusted from PesaPal's GetTransactionStatus, never from the callback URL.
MCP Registry
- step 0: update version in server.json
- step 1: curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')\_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher chmod +x mcp-publisher
- step 2: ./mcp-publisher login github ./mcp-publisher validate server.json ./mcp-publisher publish server.json
MCP
- Do the first command from outside the folder you want to create.
- Change my-mcp-server to the name of your server scaffold: npm create cloudflare@latest -- my-mcp-server --template=cloudflare/ai/demos/remote-mcp-authless get token for workers from cloudflare cd my-mcp npm install npx wrangler dev # local dev npx wrangler deploy # deploy
Frequently asked questions
What is Uganda Online Business Directory?
Search a Ugandan business directory for businesses and services by keyword, category, or district
How do I install Uganda Online Business Directory?
It runs as a remote server. In Claude Code: claude mcp add --transport http uganda-online-business-directory 'https://ug-online.domus-dei-tech.workers.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Uganda Online Business Directory need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Uganda Online Business Directory open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Uganda Online Business Directory?
It is published by domusdeiug. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.