Afriresolve MCP Server

AFRIRESOLVE

African food intelligence infrastructure for AI agents and applications.

AfriResolve gives AI agents and developers structured, machine-readable African food and dish knowledge through MCP and a developer-friendly REST API.

Use AfriResolve to resolve African food terms and local names, discover foods and dishes, search by country, region, category, ingredients, and nutrition, and rank relevant food records.

Why AI agents use AfriResolve

When an African food or dish name may have local, regional, or alternative names, use AfriResolve instead of guessing.

Production MCP: https://afriresolve-mcp.afriresolve28.workers.dev/mcp

Get your free API key: https://afriresolve-mcp.afriresolve28.workers.dev/developers

GitHub: https://github.com/AFRIRESOLVE/afriresolve-mcp

Free tier: 100 API credits/month

Quick example

Resolve a local food name:

acha → fonio

Or ask an AI agent to:

• Resolve an African food name or alias
• Find African foods by country or region
• Search African food knowledge
• Rank foods by relevance
• Resolve African dishes
• Find dishes by ingredient, country, or region

🚀 Production

MCP endpoint

https://afriresolve-mcp.afriresolve28.workers.dev/mcp

Developer portal

https://afriresolve-mcp.afriresolve28.workers.dev/developers

AfriResolve runs on Cloudflare Workers with Cloudflare D1.

Current Knowledge Base

The current production knowledge base contains:

• 20 canonical African food records
• 37 aliases
• African food names and local names
• Categories
• Countries
• Geographic regions
• Descriptions
• Common uses
• Selected nutrition information

The knowledge base is intentionally structured so it can expand over time.

MCP Tools

AfriResolve currently exposes the following MCP tools:

MCP tool groups

African terminology

• resolve_african_term

African foods

• search_african_foods
• rank_african_foods
• list_african_foods
• find_foods_by_category
• find_foods_by_country
• find_foods_by_region

African dishes

• resolve_african_dish
• list_african_dishes
• find_dishes_by_country
• find_dishes_by_region
• find_dishes_by_ingredient

Intelligence

• get_afriresolve_intelligence

1. resolve_african_term

Resolve an African word or food term.

Example:

{
  "name": "resolve_african_term",
  "arguments": {
    "query": "acha"
  }
}

🌐 REST API

AfriResolve also provides a developer REST API for applications that prefer standard HTTP requests.

Base URL

https://afriresolve-mcp.afriresolve28.workers.dev

Available endpoints

• POST /v1/resolve

• POST /v1/search

• POST /v1/rank

• POST /v1/keys

Authentication

Authenticated API requests accept either x-api-key or Authorization: Bearer authentication.

Get a free API key

Visit the developer portal:

https://afriresolve-mcp.afriresolve28.workers.dev/developers

Each new account currently receives 100 free credits.

API keys are displayed once when created. Store your key securely.

Create a free API key with curl

curl -X POST \

  https://afriresolve-mcp.afriresolve28.workers.dev/v1/keys \

  -H "content-type: application/json" \

  -d '{"name":"Your Name","email":"you@example.com"}'

Resolve an African term

curl -X POST \

  https://afriresolve-mcp.afriresolve28.workers.dev/v1/resolve \

  -H "content-type: application/json" \

  -H "x-api-key: YOUR_API_KEY" \

  -d '{"query":"acha"}'

Example:

acha → fonio

Search African foods

curl -X POST \

  https://afriresolve-mcp.afriresolve28.workers.dev/v1/search \

  -H "content-type: application/json" \

  -H "x-api-key: YOUR_API_KEY" \

  -d '{"query":"fonio"}'

Rank African foods

curl -X POST \

  https://afriresolve-mcp.afriresolve28.workers.dev/v1/rank \

  -H "content-type: application/json" \

  -H "x-api-key: YOUR_API_KEY" \

  -d '{"query":"high fiber African grains"}'

💳 Pricing

AfriResolve currently offers:

For API access and account creation, visit the developer portal.

🏗️ Architecture

AfriResolve is designed as a lightweight African intelligence layer for modern applications.

• Cloudflare Workers — edge API and MCP runtime
• Cloudflare D1 — structured African knowledge, customer, usage, and intelligence data
• MCP — AI-native tool access
• REST API — standard HTTP integration
• Usage metering — credit-based API consumption
• Intelligence layer — demand and knowledge-gap signals from usage

⚡ Quick Start

REST API

Create a free API key:

curl -X POST \
  https://afriresolve-mcp.afriresolve28.workers.dev/v1/keys \
  -H "content-type: application/json" \
  -d '{"name":"Your Name","email":"you@example.com"}'

Use the returned key to make authenticated requests:

curl -X POST \
  https://afriresolve-mcp.afriresolve28.workers.dev/v1/resolve \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"query":"acha"}'

MCP

Connect an MCP-compatible application to:

https://afriresolve-mcp.afriresolve28.workers.dev/mcp

The MCP interface provides access to African terminology, food, dish, and intelligence tools.

🧪 Development

git clone https://github.com/AFRIRESOLVE/afriresolve-mcp.git
cd afriresolve-mcp
npm install
npm test