{
  "markdown": "# BugiaData MCP\n\n**Relational fake data for AI editors** — locale-aware, foreign keys intact, one API key.\n\nBugiaData is a **hosted remote MCP server**. You do not clone or run this repository to use the tools; it exists for **documentation and directory listings** (cursor.store, MCP Registry). The server runs at [bugiadata.com](https://bugiadata.com).\n\n| | |\n|---|---|\n| **MCP endpoint** | `https://mcp.bugiadata.com/sse` |\n| **Auth** | HTTP header `X-API-Key` (from your [dashboard](https://bugiadata.com/dashboard?tab=mcp)) |\n| **Discovery** | [bugiadata.com/mcp](https://bugiadata.com/mcp) |\n| **Signup** | [bugiadata.com/signup](https://bugiadata.com/signup) (free tier: 10k tokens/month) |\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `ping` | Health check; returns tier and key hint |\n| `whoami` | Account tier and monthly token usage |\n| `generate_data` | Single Faker type batch (e.g. `name`, `email`) — mirrors REST `POST /api/generate` |\n| `generate_relational_data` | Multi-table JSON with `foreign_key` columns — mirrors REST `POST /api/generate/schema` |\n\nAsk your agent in natural language; it should map the request to tool arguments before calling.\n\n## Quick setup\n\n1. [Sign up](https://bugiadata.com/signup) (or sign in).\n2. Open **Dashboard → MCP** and copy your API key.\n3. Add the config below for your client.\n4. Restart the client and try: *\"Use BugiaData to generate 5 users with pt_BR locale.\"*\n\n### Cursor\n\nProject: `.cursor/mcp.json` · Global: `~/.cursor/mcp.json` (Windows: `%USERPROFILE%\\.cursor\\mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"bugiadata\": {\n      \"url\": \"https://mcp.bugiadata.com/sse\",\n      \"headers\": {\n        \"X-API-Key\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nSee [examples/cursor-mcp.json](examples/cursor-mcp.json).\n\n### Claude Desktop\n\nEdit `claude_desktop_config.json` (same `mcpServers` block as above).\n\nSee [examples/claude-desktop.json](examples/claude-desktop.json).\n\n### Claude Code\n\nEdit `~/.claude/mcp.json` (same `mcpServers` block as above).\n\n### Windsurf\n\nEdit `~/.codeium/windsurf/mcp_config.json` (same `mcpServers` block as above).\n\nSee [examples/windsurf-mcp.json](examples/windsurf-mcp.json).\n\n## Example prompts\n\n- *\"Ping BugiaData and show my quota.\"*\n- *\"Generate 20 emails and names with locale en_US.\"*\n- *\"Generate users and orders: orders.author_id must reference users.id, locale pl_PL.\"*\n\n## Relational schema shape\n\n`generate_relational_data` expects a table map. Simplified example:\n\n```json\n{\n  \"users\": {\n    \"columns\": {\n      \"id\": { \"type\": \"uuid\" },\n      \"name\": { \"type\": \"name\" },\n      \"email\": { \"type\": \"email\" }\n    }\n  },\n  \"orders\": {\n    \"columns\": {\n      \"id\": { \"type\": \"uuid\" },\n      \"user_id\": { \"type\": \"foreign_key\", \"reference\": \"users.id\" },\n      \"total\": { \"type\": \"pydecimal\", \"left_digits\": 3, \"right_digits\": 2 }\n    }\n  }\n}\n```\n\nFull REST/MCP docs: [bugiadata.com/docs](https://bugiadata.com/docs)\n\n## Directory listings\n\n| Directory | URL |\n|-----------|-----|\n| **cursor.store** | https://www.cursor.store/mcp/lgpoliveira/bugiadata-mcp |\n| **MCP Registry** | https://registry.modelcontextprotocol.io/v0/servers?search=bugiadata (`io.github.lgpoliveira/bugiadata-mcp` v1.0.0) |\n\nTo enrich the cursor.store page (custom copy, install snippet, category), sign in with GitHub and claim the repo — paste-ready fields are in [`docs/CURSOR_STORE_LISTING.md`](docs/CURSOR_STORE_LISTING.md).\n\n## MCP Registry\n\nThis repo includes [`server.json`](server.json) for the [official MCP Registry](https://modelcontextprotocol.io/registry). Publishing is optional; see issue tracker on the private product repo.\n\n## Security\n\n- Never commit real API keys. Use placeholders in config files.\n- Keys are created and rotated in the [BugiaData dashboard](https://bugiadata.com/dashboard?tab=mcp) only.\n- Generation consumes your monthly token quota (same as the REST API).\n\n## Links\n\n- Product: https://bugiadata.com  \n- MCP landing: https://bugiadata.com/mcp  \n- JSON discovery: https://mcp.bugiadata.com/.well-known/mcp.json  \n\n## License\n\nMIT — applies to this documentation repository only. The BugiaData application and MCP server implementation are proprietary.\n",
  "bytes": 4177,
  "sha": "e83d5ba6df689d2c0fe6c38fdea2a953ed79bac6ead08212935f90d95e20dffd",
  "repo_slug": "lgpoliveira/bugiadata-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_lgpoliveira_bugiadata_mcp_bed991d0/readme"
}