# TSUNAGI///Matrix — MAPPING

> TSUNAGI///Matrix — MAPPING is an open-source MCP server for automotive tuning. Tune BMW E46 M3 engine maps and decode SMG II calibrations from logs and ECU files. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://m3.tsunagi.app
- **Repository:** https://github.com/mushitaro/matrix-tsunagi
- **MCP Registry name:** io.github.mushitaro/matrix-tsunagi-mapping
- **Categories:** automotive tuning
- **Listing updated:** 2026-11-15

## About

Everything runs on your own machine, with no car and no cable: you give it files, it gives back calculations. Feed it an MSS54HP engine ECU image plus a Testo drive log and it returns the volumetric efficiency (VE) correction the drive supports, which cells change, which need more driving and how to drive them, and optionally a tuned file with checksums fixed. The README says that file matches what the TUNER app's download produces.

Other commands inspect a bin file's contents, checksums and patches, explain why log samples were discarded (cold engine, transients, full load, overrun), and sketch an experimental exhaust-temperature (rf_korr) correction table. For SMG II gearbox images it identifies the image type, ZB number and CRC state, decodes shift speeds, gear ratios and clutch and launch settings, and compares two calibrations.

This server is the mapping category of TSUNAGI///Matrix, which the README says computes nothing itself and carries each tool's code to the assistant. It ships practice files, and the MS4X definition file for SMG decoding is not included.

## Features

- **VE map correction:** Computes cell-by-cell corrections from an ECU image and a drive log.
- **Log rejection reasons:** Explains why samples were dropped and what to change next drive.
- **SMG II decoding:** Reads shift speeds, gear ratios and clutch settings from a calibration.
- **Calibration comparison:** Shows what changed between two SMG II files.
- **Offline practice mode:** Sample files let you try it without your own data.

## Good for

- Correct a CSL-converted MSS54HP VE map from a drive log
- Check an ECU bin's checksums and patches
- Compare two gearbox calibrations
- Work out why most of a log was excluded

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http matrix-tsunagi-mapping https://matrix-mcp.tsunagi.app/mcp/mapping
```

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

```sh
https://matrix-mcp.tsunagi.app/mcp/mapping
```

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

```json
{
  "mcpServers": {
    "matrix-tsunagi-mapping": {
      "url": "https://matrix-mcp.tsunagi.app/mcp/mapping"
    }
  }
}
```

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

```json
{
  "servers": {
    "matrix-tsunagi-mapping": {
      "type": "http",
      "url": "https://matrix-mcp.tsunagi.app/mcp/mapping"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "matrix-tsunagi-mapping": {
      "serverUrl": "https://matrix-mcp.tsunagi.app/mcp/mapping"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "matrix-tsunagi-mapping": {
      "type": "http",
      "url": "https://matrix-mcp.tsunagi.app/mcp/mapping"
    }
  }
}
```

## FAQ

### Does it need a connected car?

No. It works on files on your own machine.

### How do I try it?

Run `npx matrix-tsunagi mapping ve --sample` to use the shipped practice files.

### Which car is it for?

The BMW E46 M3 with the S54 engine, MSS54HP DME and SMG II gearbox.

### Is the SMG definition file included?

No. You supply the MS4X Dev Team's definition file yourself.

### Is TSUNAGI///Matrix — MAPPING free?

Yes. TSUNAGI///Matrix — MAPPING is open source, so you can use and self-host it for free.

### How do I add TSUNAGI///Matrix — MAPPING to Claude Code?

Run this command in your terminal: claude mcp add --transport http matrix-tsunagi-mapping https://matrix-mcp.tsunagi.app/mcp/mapping

## Alternatives

- [TSUNAGI///Matrix — MIGRATION](https://ai-powered.com/mcp/tsunagi-matrix-migration): TSUNAGI///Matrix — MIGRATION is an open-source MCP server for automotive tuning.

---
Source: https://ai-powered.com/mcp/tsunagi-matrix-mapping
