# massa

> massa is a free MCP server for files and documents. Valid Brazilian test data (CPF, CNPJ, cards, accounts) for assistants, no key needed. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://massa.criando.dev/mcp
- **Repository:** https://github.com/criando-dev/massa
- **MCP Registry name:** dev.criando/massa
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-15

## About

Test data for Brazilian systems has to pass check-digit rules, which a language model tends to get wrong when it invents numbers. This server has the assistant call massa's own engine, which calculates the check digits and takes a seed so the same request reproduces the same output. The documents are random and made for software testing: they have valid format but belong to no one and may coincide with real ones, so they must not go into real registrations.

It needs no account, key or sign-in. The tools are read-only and nothing is written. A generation call returns up to 100 rows, since results enter the chat. Beyond that it returns the schema and a curl command for the massa API, which produces up to 10,000 rows per request, and an Excel request returns a download link without the row cap. There is a per-IP limit per minute, shared with other users when a provider's cloud makes the call.

The site documents setup for Claude, Claude Code, ChatGPT in developer mode, Cursor and VS Code. Its privacy note says call arguments and generated data are never logged.

## Features

- **Calculated check digits:** Generates documents whose verification digits are computed, not guessed.
- **Reproducible seeds:** Returns the seed used so a dataset can be regenerated.
- **DDL import:** Turns a CREATE TABLE from Postgres, MySQL, Oracle or SQL Server into a generation schema.
- **Multiple output formats:** Returns CSV, JSON, INSERT scripts or an Excel download link.
- **Alphanumeric CNPJ:** Supports the alphanumeric CNPJ format when generating and validating.
- **Document validation:** Checks a CPF, CNPJ, card, branch or account number, with or without masks.

## Good for

- Generate 10 customers with name, CPF, email and bank account as CSV
- Check whether an alphanumeric CNPJ is valid
- Turn a CREATE TABLE into 50 rows of INSERT statements
- Create Mastercard test numbers with expiry and CVV for a checkout test
- Seed a test database reproducibly

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http massa https://massa.criando.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://massa.criando.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "massa": {
      "url": "https://massa.criando.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "massa": {
      "type": "http",
      "url": "https://massa.criando.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "massa": {
      "serverUrl": "https://massa.criando.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "massa": {
      "type": "http",
      "url": "https://massa.criando.dev/mcp"
    }
  }
}
```

## Tools

- `listar_tipos`: Lists the column types massa can generate and their parameters.
- `importar_ddl`: Converts a CREATE TABLE into a generation schema.
- `gerar`: Generates rows from a schema as CSV, JSON, SQL INSERTs or an Excel link.
- `gerar_documento`: Generates a single valid CPF, CNPJ, card, account or password.
- `validar_documento`: Validates a CPF, CNPJ, card, branch or account number.

## FAQ

### Do I need an account or API key?

No. The server is free, anonymous and has no authentication, only a per-minute limit by IP.

### Are the generated documents real people's?

No. They are random with valid format and digits, belong to nobody, and may coincide with real ones, so do not use them in real registrations.

### How do I get more than 100 rows?

The generate tool returns a schema and a curl command for the massa API, which gives up to 10,000 rows per request. Excel links have no such cap.

### What does massa log?

Technical request data, tool name and client name and version. Request arguments and generated data are never logged.

### Is massa free?

Yes. massa is free to use.

### How do I add massa to Claude Code?

Run this command in your terminal: claude mcp add --transport http massa https://massa.criando.dev/mcp

### What are the best alternatives to massa?

The closest alternatives to massa are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/massa
