AfriResolve

Official13 tools

by AFRIRESOLVE · JavaScript

African intelligence infrastructure for AI apps, developers, and data products via MCP.

The io.github.AFRIRESOLVE/afriresolve-mcp server provides an African intelligence infrastructure for AI applications, developers, and data products via the Model Context Protocol (MCP). It also exposes a developer-friendly REST API to serve structured, machine-readable African knowledge.

🛠️ Key Features

Model Context Protocol (MCP) interface
Developer-friendly REST API
Structured data for African terms and knowledge

🚀 Use Cases

Resolve African terms for AI systems and applications
Discover African foods and dishes
Build Africa-focused applications using structured data

⚡ Developer Benefits

Tooling for AI apps and developers through MCP
REST API access for integration
Free API key available for development

⚠️ Limitations

Documentation excerpt only mentions a free API key and a “free tier” without further details.
Scope described is limited to African terms and foods/dishes.

Topics

africaafrican-techaiapiartificial-intelligencedata-infrastructuredeveloper-toolsmcpmodel-context-protocolrest-api

Captured live from the server via tools/list.

resolve_african_dish

Resolve an African dish name or alias and return standardized dish information.

Parameters1

query

string

required

The African dish name or alias to resolve

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "The African dish name or alias to resolve"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_african_dishes

List all standardized African dish records in the AfriResolve knowledge base.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_dishes_by_country

Find African dishes associated with a specific African country.

Parameters1

country

string

required

Country to search for

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 1,
      "description": "Country to search for"
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_dishes_by_region

Find African dishes associated with a geographic region such as West Africa or Central Africa.

Parameters1

region

string

required

African region to search for

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "minLength": 1,
      "description": "African region to search for"
    }
  },
  "required": [
    "region"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_dishes_by_ingredient

Find African dishes that use a specific ingredient or food.

Parameters1

ingredient

string

required

Ingredient or food to search for

Raw schema

{
  "type": "object",
  "properties": {
    "ingredient": {
      "type": "string",
      "minLength": 1,
      "description": "Ingredient or food to search for"
    }
  },
  "required": [
    "ingredient"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

resolve_african_term

Resolve an African word or food term and return standardized information.

Parameters1

query

string

required

The African term to resolve

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "The African term to resolve"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_african_foods

List all standardized African food records in the AfriResolve knowledge base.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_foods_by_category

Find African foods by category such as grain, root, fruit, legume, seed, tuber, vegetable, or leafy_vegetable.

Parameters1

find_foods_by_country

Find African foods associated with a specific African country.

Parameters1

country

string

required

Country to search for

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "minLength": 1,
      "description": "Country to search for"
    }
  },
  "required": [
    "country"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

find_foods_by_region

Find African foods associated with a geographic region such as West Africa or Central Africa.

Parameters1

region

string

required

African region to search for

Raw schema

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "minLength": 1,
      "description": "African region to search for"
    }
  },
  "required": [
    "region"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

rank_african_foods

Search and rank African food records by relevance across names, aliases, categories, countries, regions, descriptions, uses, and nutrition information.

Parameters1

query

string

required

Search text for ranked African food discovery

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search text for ranked African food discovery"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

search_african_foods

Search the AfriResolve African food knowledge base across names, aliases, categories, countries, regions, descriptions, uses, and nutrition information.

Parameters1

query

string

required

Search text for discovering African food records

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Search text for discovering African food records"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_afriresolve_intelligence

Return aggregated AfriResolve usage intelligence, including total activity, demand signals, popular queries, tool usage, and recurring knowledge gaps.

Parameters1

limit

integer

optional

Maximum number of rows returned in each intelligence list

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Maximum number of rows returned in each intelligence list",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md6 KBView on GitHub

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:

json

{
  "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

bash


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

bash


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

bash


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

bash


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:

Plan	Credits	Price
Free	100/month	$0
Developer	10,000/month	$29
Pro	100,000/month	$199
Enterprise	1,000,000/month	$999

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:

bash

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:

bash

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

bash

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

Install

Tools (13)

resolve_african_dishlist_african_dishesfind_dishes_by_countryfind_dishes_by_regionfind_dishes_by_ingredientresolve_african_termlist_african_foodsfind_foods_by_category

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

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

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "afriresolve-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://afriresolve-mcp.afriresolve28.workers.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

resolve_african_dish

list_african_dishes

find_dishes_by_country

find_dishes_by_region

find_dishes_by_ingredient

resolve_african_term

list_african_foods

find_foods_by_category

find_foods_by_country

find_foods_by_region

rank_african_foods

search_african_foods

get_afriresolve_intelligence

AFRIRESOLVE

Why AI agents use AfriResolve

Quick example

🚀 Production

Current Knowledge Base

MCP Tools

MCP tool groups

1. resolve_african_term

🌐 REST API

Base URL

Available endpoints

Authentication

Get a free API key

Create a free API key with curl

Resolve an African term

Search African foods

Rank African foods

💳 Pricing

🏗️ Architecture

⚡ Quick Start

REST API

MCP

🧪 Development

Install

Remote endpoint

Related servers