ነጋ MCP Documentation

Ethiopia's AI Commerce Layer

Quick Install

Add to Claude Desktop

{
  "mcpServers": {
    "nega": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.nega-marketplace.com/mcp"
      ]
    }
  }
}

Config file locations

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Add to Cursor

{
  "mcpServers": {
    "nega": {
      "url": "https://mcp.nega-marketplace.com/mcp",
      "type": "http"
    }
  }
}

Try These Prompts

🛒 Find electronics for sale near Bole in Addis Ababa under $500

🌾 Search teff farmers in Gonder Ethiopia selling minimum 100kg

☕ Find Yirgacheffe coffee exporters with EUDR certification

🌍 Find habesha kemis that ships to Washington DC under $100

📊 What is the average price of iPhone 15 in Addis Ababa?

11 Available Tools

Tool	Description	Auth	Rate Limit
`search_listings`	Search marketplace by keyword (EN/AM), category, price, location	None	30/min
`search_produce`	Agricultural produce from Ethiopian farmers	None	30/min
`search_coffee_exporters`	Verified coffee exporters by region, certification	None	10/min
`get_market_insights`	Price trends and market data	None	10/min
`search_diaspora_products`	Products shipping internationally	None	30/min
`search_abiro_deals`	Active አብሮ group buying deals (ቅርጫ / ሸመታ)	None	30/min
`get_listing`	Full listing details	None	60/min
`get_seller`	Seller profile and ratings	None	60/min
`list_categories`	All categories EN + AM	None	10/min
`get_active_auctions`	Live auctions with timers	None	20/min
`send_message`	Message a seller	Bearer	5/min
`get_my_wallet`	Wallet balance	Bearer	20/min

Authentication

Public Tools

Most tools require no authentication. Just connect and query.

Protected Tools

send_message and get_my_wallet require a Nega user Bearer token.

When auth is missing the server returns HTTP 401 with a WWW-Authenticate header:

WWW-Authenticate: Bearer
  error="invalid_token",
  error_description="Missing Authorization header",
  resource_metadata="https://mcp.nega-marketplace.com/.well-known/oauth-protected-resource"

OAuth Discovery

Protected Resource Metadata (RFC 9728):

https://mcp.nega-marketplace.com/.well-known/oauth-protected-resource

Authorization Server:

https://auth.nega-marketplace.com/realms/Nega

Rate Limits

Global: 120 requests/minute per IP

When exceeded the server returns HTTP 429:

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32029,
    "message": "Rate limit exceeded. Retry after 60s.",
    "data": {
      "retry_after": 60
    }
  }
}

💡 Implement exponential backoff when you receive a 429 response.

What Nega Covers

🛒 Marketplace

Electronics · Vehicles · Property · Fashion · Services · Jobs · Furniture · Habesha Kemis · Ethiopian Food

🌾 Agriculture

Direct from Ethiopian farmers · Teff · Coffee · Vegetables · Livestock · Dairy · Spices

🌍 Diaspora

Products shipping to: USA · UK · UAE · Sweden · Canada