Skip to content
Back to search

safakedata-mcp

MCP server for SA Fake Data: realistic South African test data (ID numbers, bank accounts, addresses, companies) for Claude, Cursor and other AI tools

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/donovangriggs--safakedata-mcp/badge.svg)](/listings/donovangriggs--safakedata-mcp)

HTML

<a href="/listings/donovangriggs--safakedata-mcp"><img src="/api/listings/donovangriggs--safakedata-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The server runs over stdio with `npx` and reads the key from `SAFAKEDATA_API_KEY`. Node.js 22 or newer.

Claude Code

claude mcp add safakedata -e SAFAKEDATA_API_KEY=safk_your_key -- npx -y safakedata-mcp

Claude Desktop

Add this to `claude_desktop_config.json` (Settings → Developer → Edit Config) and restart Claude Desktop:

{
  "mcpServers": {
    "safakedata": {
      "command": "npx",
      "args": ["-y", "safakedata-mcp"],
      "env": { "SAFAKEDATA_API_KEY": "safk_your_key" }
    }
  }
}

Cursor

Add this to `~/.cursor/mcp.json`, or `.cursor/mcp.json` in a project:

{
  "mcpServers": {
    "safakedata": {
      "command": "npx",
      "args": ["-y", "safakedata-mcp"],
      "env": { "SAFAKEDATA_API_KEY": "safk_your_key" }
    }
  }
}

Any other MCP client that can launch a stdio server works the same way.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 160 lines
  1. # safakedata-mcp
  2. [![CI](https://github.com/donovangriggs/safakedata-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/donovangriggs/safakedata-mcp/actions/workflows/ci.yml)
  3. [![npm](https://img.shields.io/npm/v/safakedata-mcp)](https://www.npmjs.com/package/safakedata-mcp)
  4. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  5. An [MCP](https://modelcontextprotocol.io) server that gives Claude, Cursor and other AI tools realistic South African test data: people, SA ID numbers, bank accounts, addresses and companies.
  6. It is a small client for the [SA Fake Data](https://www.safakedata.dev) API. Ask your assistant for "ten test customers" or "a few valid SA ID numbers" while you write seed scripts, fixtures or form tests, and it calls the API for you.
  7. All data is generated. ID numbers pass the Luhn check and registration and VAT numbers use the real formats, but none of it belongs to a real person, account or business.
  8. ## Get a free API key
  9. 1. Sign up at [safakedata.dev/register](https://www.safakedata.dev/register) and verify your email.
  10. 2. Create a key on the [API keys](https://www.safakedata.dev/keys) page. It starts with `safk_`.
  11. The free plan includes 500 requests a month. Each tool call is one request, whatever the `count`.
  12. ## Install
  13. The server runs over stdio with `npx` and reads the key from `SAFAKEDATA_API_KEY`. Node.js 22 or newer.
  14. ### Claude Code
  15. ```sh
  16. claude mcp add safakedata -e SAFAKEDATA_API_KEY=safk_your_key -- npx -y safakedata-mcp
  17. ```
  18. ### Claude Desktop
  19. Add this to `claude_desktop_config.json` (Settings → Developer → Edit Config) and restart Claude Desktop:
  20. ```json
  21. {
  22. "mcpServers": {
  23. "safakedata": {
  24. "command": "npx",
  25. "args": ["-y", "safakedata-mcp"],
  26. "env": { "SAFAKEDATA_API_KEY": "safk_your_key" }
  27. }
  28. }
  29. }
  30. ```
  31. ### Cursor
  32. Add this to `~/.cursor/mcp.json`, or `.cursor/mcp.json` in a project:
  33. ```json
  34. {
  35. "mcpServers": {
  36. "safakedata": {
  37. "command": "npx",
  38. "args": ["-y", "safakedata-mcp"],
  39. "env": { "SAFAKEDATA_API_KEY": "safk_your_key" }
  40. }
  41. }
  42. }
  43. ```
  44. Any other MCP client that can launch a stdio server works the same way.
  45. ## Tools
  46. Every tool takes the same two optional inputs:
  47. | Input | Type | Notes |
  48. | ------- | ------- | ------------------------------------------------------------ |
  49. | `count` | integer | 1 to 100 records. Default 1. |
  50. | `seed` | integer | 0 to 2147483647. The same seed always returns the same data. |
  51. | Tool | Returns | Example prompt |
  52. | ----------------------- | ------------------------------------------------------------------------------ | --------------------------------------------------------- |
  53. | `generate_person` | Name, email, phone, gender, date of birth, SA ID number and home address | "Make 10 test users and write them to `seed/users.json`." |
  54. | `generate_sa_id` | 13-digit SA ID number with the date of birth, gender and citizenship it encodes | "Give me 3 valid SA ID numbers for my validator tests." |
  55. | `generate_bank_account` | Bank name, account number, branch code and account type | "I need a fake bank account to fill in the debit order form." |
  56. | `generate_address` | Street, suburb, city, province and postal code | "Generate 20 addresses to test the province dropdown." |
  57. | `generate_company` | Company name, CIPC registration number, VAT number, industry and type | "Create a few suppliers with VAT numbers for the invoice fixtures." |
  58. ### Sample output
  59. `generate_sa_id` with `{ "count": 2, "seed": 42 }`:
  60. ```json
  61. [
  62. {
  63. "idNumber": "9709052632087",
  64. "dateOfBirth": "1997-09-05",
  65. "gender": "female",
  66. "citizenship": "citizen"
  67. },
  68. {
  69. "idNumber": "9806079410081",
  70. "dateOfBirth": "1998-06-07",
  71. "gender": "male",
  72. "citizenship": "citizen"
  73. }
  74. ]
  75. ```
  76. `generate_company` with `{ "seed": 7 }`:
  77. ```json
  78. [
  79. {
  80. "name": "Africa Solutions Inc",
  81. "registrationNumber": "2008/464969/11",
  82. "vatNumber": "4315932667",
  83. "industry": "Transport",
  84. "type": "Inc"
  85. }
  86. ]
  87. ```
  88. Each result also reports how many requests you have left this month.
  89. ### Errors
  90. Problems come back as tool errors your assistant can read and explain:
  91. - no key, or an invalid or revoked key: how to set `SAFAKEDATA_API_KEY` and where to get a key
  92. - email not verified: verify it from the email safakedata.dev sent you
  93. - monthly limit reached: when the quota resets
  94. - too many requests in a short burst: wait a minute and retry
  95. ## Development
  96. ```sh
  97. git clone https://github.com/donovangriggs/safakedata-mcp.git
  98. cd safakedata-mcp
  99. npm install
  100. npm test # unit tests with a mocked fetch
  101. npm run lint
  102. npm run typecheck
  103. npm run build # compiles to dist/
  104. ```
  105. `test/live.test.ts` calls the real API and is skipped unless `SAFAKEDATA_API_KEY` is set:
  106. ```sh
  107. SAFAKEDATA_API_KEY=safk_your_key npm test
  108. ```
  109. To try a local build in Claude Code: `claude mcp add safakedata-dev -e SAFAKEDATA_API_KEY=safk_your_key -- node /path/to/safakedata-mcp/dist/index.js`.
  110. ### Releases
  111. CI runs lint, typecheck, tests and build on every push to `main` and every pull request, on Node 22, 24 and 26.
  112. Pushing a `v*` tag that matches the `package.json` version runs `.github/workflows/release.yml`, which publishes to npm with provenance. It needs an `NPM_TOKEN` repository secret holding an npm automation token with publish rights to `safakedata-mcp`.
  113. ## Related
  114. - [safakedata.dev](https://www.safakedata.dev): the API this server calls, with docs and a playground
  115. - [kal](https://github.com/donovangriggs/kal): AI helpers for Claude Code that each work in their own copy of the code, with a human gate
  116. ## License
  117. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.