Naija Faker MCP Server
MCP server for @codegrenade/naija-faker. Let's AI assistant generates fake typical Nigerian data ranging from name, address, phone number, LGAs and states for you. It supports Yoruba, Igbo, and Hausa ethnic groups with culturally authentic data.
NB: You can invoke the server in any AI assistant that supports MCP.
Quick Start
Add to your Claude Desktop config at:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"naija-faker-mcp": {
"command": "npx",
"args": ["-y", "@codegrenade/naija-faker-mcp@latest"]
}
}
}
PS: You can also use the inspector to debug the server. See the development section for more information.
Available tools
| Tool | Description |
|---|---|
| generate_person | Generate a fake person with Nigerian characteristics. |
| generate_address | Generate a fake Nigerian address. |
| generate_phone_number | Generate a fake Nigerian phone number. |
| generate_lgas | Generate fake Nigerian LGAs. |
| generate_states | Generate fake Nigerian states. |
| generate_email | Generate a fake Nigerian email. |
| generate_nin | Generate a fake Nigerian NIN. |
| generate_bvn | Generate a fake Nigerian BVN. |
| generate_license_plate | Generate a fake Nigerian license plate. |
| generate_people | Generate a list of fake Nigerian people. |
| generate_title | Generate a fake Nigerian title. |
| generate_name | Generate a fake Nigerian name. |
| generate_vehicle_record | Generate a fake Nigerian vehicle record. |
| generate_company | Genereate a fake Nigerian company. |
| generate_university | Generate a fake Nigerian university |
| generate_education_record | Generate a fake Nigerian education record |
| generate_work_record | Generate a fake Nigerian work record |
| generate_detailed_person | Generate a fake Nigerian person with detailed information |
| generate_detailed_people | Generate a list of fake Nigerian people with detailed information |
| generate_date_of_birth | Generate a fake date of birth |
| genereate_marital_status | Genereate a fake marital status |
| generate_blood_group | Generate a fake blood group |
| generate_genotype | Generate a fake genotype |
| generate_salary | Generate a fake salary |
| generate_next_of_kin | Generate a fake Nigerian next of kin |
| generate_bank_account | Generate a fake Nigerian bank account |
| generate_consistent_person | Generate a fake Nigerian person with consistent data |
| generate_consistent_people | Generate a list of fake Nigerian people with consistent data |
Development
Clone Repository
git clone https://github.com/kodegrenade/naija-faker-mcp.git
Navigate to the project directory
cd naija-faker-mcp
Install dependencies
npm install
Run the server
npm run dev
Debug with inspector
npx @modelcontextprotocol/inspector npm run dev
License
MIT