{
  "markdown": "# AFRIRESOLVE\n\n**African intelligence infrastructure for AI applications, developers, and data products.**\n\nAfriResolve is a machine-readable African knowledge and intelligence service exposed through the **Model Context Protocol (MCP)** and a developer-friendly **REST API**.\n\nIt helps AI systems and applications resolve African terms, discover African foods and dishes, and build Africa-focused applications on structured data.\n\n**👉 Get your free API key:** https://afriresolve-mcp.afriresolve28.workers.dev/developers\n**📖 GitHub:** https://github.com/AFRIRESOLVE/afriresolve-mcp\n**🎯 Free tier:** 100 API credits/month\n\n## 🚀 Production\n\n**MCP endpoint**\n\nhttps://afriresolve-mcp.afriresolve28.workers.dev/mcp\n\n**Developer portal**\n\nhttps://afriresolve-mcp.afriresolve28.workers.dev/developers\n\nAfriResolve runs on Cloudflare Workers with Cloudflare D1.\n\n## Current Knowledge Base\n\nThe current production knowledge base contains:\n\n- 20 canonical African food records\n- 37 aliases\n- African food names and local names\n- Categories\n- Countries\n- Geographic regions\n- Descriptions\n- Common uses\n- Selected nutrition information\n\nThe knowledge base is intentionally structured so it can expand over time.\n\n## MCP Tools\n\nAfriResolve currently exposes the following MCP tools:\n\n### MCP tool groups\n\n**African terminology**\n- `resolve_african_term`\n\n**African foods**\n- `search_african_foods`\n- `rank_african_foods`\n- `list_african_foods`\n- `find_foods_by_category`\n- `find_foods_by_country`\n- `find_foods_by_region`\n\n**African dishes**\n- `resolve_african_dish`\n- `list_african_dishes`\n- `find_dishes_by_country`\n- `find_dishes_by_region`\n- `find_dishes_by_ingredient`\n\n**Intelligence**\n- `get_afriresolve_intelligence`\n\n### 1. resolve_african_term\n\nResolve an African word or food term.\n\nExample:\n\n```json\n{\n  \"name\": \"resolve_african_term\",\n  \"arguments\": {\n    \"query\": \"acha\"\n  }\n}\n```\n\n## 🌐 REST API\n\n\n\nAfriResolve also provides a developer REST API for applications that prefer standard HTTP requests.\n\n\n\n### Base URL\n\n\n\n`https://afriresolve-mcp.afriresolve28.workers.dev`\n\n\n\n### Available endpoints\n\n\n\n- `POST /v1/resolve`\n\n- `POST /v1/search`\n\n- `POST /v1/rank`\n\n- `POST /v1/keys`\n\n\n\n### Authentication\n\n\n\nAuthenticated API requests accept either `x-api-key` or `Authorization: Bearer` authentication.\n\n\n\n### Get a free API key\n\n\n\nVisit the developer portal:\n\n\n\nhttps://afriresolve-mcp.afriresolve28.workers.dev/developers\n\n\n\nEach new account currently receives **100 free credits**.\n\n\n\nAPI keys are displayed once when created. Store your key securely.\n\n### Create a free API key with curl\n\n\n\n```bash\n\ncurl -X POST \\\n\n  https://afriresolve-mcp.afriresolve28.workers.dev/v1/keys \\\n\n  -H \"content-type: application/json\" \\\n\n  -d '{\"name\":\"Your Name\",\"email\":\"you@example.com\"}'\n\n```\n\n\n\n### Resolve an African term\n\n\n\n```bash\n\ncurl -X POST \\\n\n  https://afriresolve-mcp.afriresolve28.workers.dev/v1/resolve \\\n\n  -H \"content-type: application/json\" \\\n\n  -H \"x-api-key: YOUR_API_KEY\" \\\n\n  -d '{\"query\":\"acha\"}'\n\n```\n\n\n\nExample:\n\n\n\n`acha → fonio`\n\n\n\n### Search African foods\n\n\n\n```bash\n\ncurl -X POST \\\n\n  https://afriresolve-mcp.afriresolve28.workers.dev/v1/search \\\n\n  -H \"content-type: application/json\" \\\n\n  -H \"x-api-key: YOUR_API_KEY\" \\\n\n  -d '{\"query\":\"fonio\"}'\n\n```\n\n\n\n### Rank African foods\n\n\n\n```bash\n\ncurl -X POST \\\n\n  https://afriresolve-mcp.afriresolve28.workers.dev/v1/rank \\\n\n  -H \"content-type: application/json\" \\\n\n  -H \"x-api-key: YOUR_API_KEY\" \\\n\n  -d '{\"query\":\"high fiber African grains\"}'\n\n```\n\n## 💳 Pricing\n\nAfriResolve currently offers:\n\n| Plan | Credits | Price |\n|---|---:|---:|\n| Free | 100/month | $0 |\n| Developer | 10,000/month | $29 |\n| Pro | 100,000/month | $199 |\n| Enterprise | 1,000,000/month | $999 |\n\nFor API access and account creation, visit the developer portal.\n\n## 🏗️ Architecture\n\nAfriResolve is designed as a lightweight African intelligence layer for modern applications.\n\n- **Cloudflare Workers** — edge API and MCP runtime\n- **Cloudflare D1** — structured African knowledge, customer, usage, and intelligence data\n- **MCP** — AI-native tool access\n- **REST API** — standard HTTP integration\n- **Usage metering** — credit-based API consumption\n- **Intelligence layer** — demand and knowledge-gap signals from usage\n\n## ⚡ Quick Start\n\n### REST API\n\nCreate a free API key:\n\n```bash\ncurl -X POST \\\n  https://afriresolve-mcp.afriresolve28.workers.dev/v1/keys \\\n  -H \"content-type: application/json\" \\\n  -d '{\"name\":\"Your Name\",\"email\":\"you@example.com\"}'\n```\n\nUse the returned key to make authenticated requests:\n\n```bash\ncurl -X POST \\\n  https://afriresolve-mcp.afriresolve28.workers.dev/v1/resolve \\\n  -H \"content-type: application/json\" \\\n  -H \"x-api-key: YOUR_API_KEY\" \\\n  -d '{\"query\":\"acha\"}'\n```\n\n### MCP\n\nConnect an MCP-compatible application to:\n\n`https://afriresolve-mcp.afriresolve28.workers.dev/mcp`\n\nThe MCP interface provides access to African terminology, food, dish, and intelligence tools.\n\n## 🧪 Development\n\n```bash\ngit clone https://github.com/AFRIRESOLVE/afriresolve-mcp.git\ncd afriresolve-mcp\nnpm install\nnpm test\n```\n",
  "bytes": 5085,
  "sha": "be47eb3e09a29306797ff3baee4b0daf7822f8dfa1db95d99fcdab1c8c0e08eb",
  "repo_slug": "afriresolve/afriresolve-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_afriresolve_afriresolve_mcp_2249af3c/readme"
}