BugiaData MCP

Relational fake data for AI editors — locale-aware, foreign keys intact, one API key.

BugiaData 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.


MCP endpoint	`https://mcp.bugiadata.com/sse`
Auth	HTTP header `X-API-Key` (from your dashboard)
Discovery	bugiadata.com/mcp
Signup	bugiadata.com/signup (free tier: 10k tokens/month)

Tools

Tool	Description
`ping`	Health check; returns tier and key hint
`whoami`	Account tier and monthly token usage
`generate_data`	Single Faker type batch (e.g. `name`, `email`) — mirrors REST `POST /api/generate`
`generate_relational_data`	Multi-table JSON with `foreign_key` columns — mirrors REST `POST /api/generate/schema`

Ask your agent in natural language; it should map the request to tool arguments before calling.

Quick setup

Sign up (or sign in).
Open Dashboard → MCP and copy your API key.
Add the config below for your client.
Restart the client and try: "Use BugiaData to generate 5 users with pt_BR locale."

Cursor

Project: .cursor/mcp.json · Global: ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json)

{
  "mcpServers": {
    "bugiadata": {
      "url": "https://mcp.bugiadata.com/sse",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

See examples/cursor-mcp.json.

Claude Desktop

Edit claude_desktop_config.json (same mcpServers block as above).

See examples/claude-desktop.json.

Claude Code

Edit ~/.claude/mcp.json (same mcpServers block as above).

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json (same mcpServers block as above).

See examples/windsurf-mcp.json.

Example prompts

"Ping BugiaData and show my quota."
"Generate 20 emails and names with locale en_US."
"Generate users and orders: orders.author_id must reference users.id, locale pl_PL."

Relational schema shape

generate_relational_data expects a table map. Simplified example:

{
  "users": {
    "columns": {
      "id": { "type": "uuid" },
      "name": { "type": "name" },
      "email": { "type": "email" }
    }
  },
  "orders": {
    "columns": {
      "id": { "type": "uuid" },
      "user_id": { "type": "foreign_key", "reference": "users.id" },
      "total": { "type": "pydecimal", "left_digits": 3, "right_digits": 2 }
    }
  }
}

Full REST/MCP docs: bugiadata.com/docs

Directory listings

Directory	URL
cursor.store	https://www.cursor.store/mcp/lgpoliveira/bugiadata-mcp
MCP Registry	https://registry.modelcontextprotocol.io/v0/servers?search=bugiadata (`io.github.lgpoliveira/bugiadata-mcp` v1.0.0)

To 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.

MCP Registry

This repo includes server.json for the official MCP Registry. Publishing is optional; see issue tracker on the private product repo.

Security

Never commit real API keys. Use placeholders in config files.
Keys are created and rotated in the BugiaData dashboard only.
Generation consumes your monthly token quota (same as the REST API).

License

MIT — applies to this documentation repository only. The BugiaData application and MCP server implementation are proprietary.