> ## Documentation Index
> Fetch the complete documentation index at: https://docs.soundchecklive.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tools

> Model Context Protocol tools for Soundcheck development

Soundcheck provides MCP (Model Context Protocol) tools for streamlined development with AI assistants like Claude. Database tools run migrations and seeds via **api-events**; mobile tools drive the Expo app.

## Overview

Prefer these launchers for day-to-day API work:

```bash theme={null}
npm run dev:infra
cd api-events && npm run dev:emulator
cd web && npm run dev:emulator
```

Use MCP `db_migrate` / `db_seed` (or the npm scripts below) for schema and seed data.

***

## Available tools

### Database

| Tool | Purpose |
| - | - |
| `db_migrate` | Run api-events Prisma migrations (`cd api-events && npm run db:migrate`) |
| `db_seed` | Seed via api-events (`db:seed:baseline` or `db:seed:demo-full`) |

### Mobile app

| Tool | Purpose |
| - | - |
| `dev_start` / `dev_stop` / `dev_restart` / `dev_status` | Manage the Expo dev server the MCP server started (Metro on `:8081`) |
| `type_check` / `lint` / `check_all` | `npm run type-check` / `lint` / `check-all` |
| `build` | EAS cloud build (`android` or `ios`) |
| `run_native` | `expo run:android` / `expo run:ios` |

Stopping the MCP server stops only a dev server it started; it never touches api-events (`:4000`) or Postgres (`:5433`).

The hosted MCP server for agents is **api-events** (`:4000/mcp`). `mcp-ts/` is the `@soundcheck/mcp` SDK.

***

## Example usage

### Database setup

```
db_migrate
db_seed with mode: "demo-full"
```

Shell equivalents:

```bash theme={null}
cd api-events
export DATABASE_URL='postgresql://postgres:postgres@localhost:5433/soundcheck?schema=public'
npm run db:migrate
npm run db:seed:demo-full
```

***

## Default local ports

| Service | Port |
| - | - |
| api-events | 4000 |
| Web | 3000 |
| PostgreSQL | 5433 |
| Clerk emulator | 4711 |
| MCP (api-events `/mcp`) | 4000 |

***

## Manual equivalents

| MCP Tool | Shell Equivalent |
| - | - |
| `db_migrate` | `cd api-events && npm run db:migrate` |
| `db_seed` | `cd api-events && npm run db:seed:baseline` (or `db:seed:demo-full`) |
| Start shared infra | `npm run dev:infra` |
| Start API | `cd api-events && npm run dev:emulator` |
| API health | `curl http://localhost:4000/health` |

***

## Troubleshooting

> [accordion] Tool not found
>
> Ensure the MCP server is configured in your Claude Code settings. Check that the `soundcheck` MCP server is listed and active.

> [accordion] Docker not running
>
> `npm run dev:infra` and database tools need Docker. Start Docker before bringing up shared infra.

> [accordion] Port conflicts
>
> ```bash theme={null}
> lsof -ti:4000
> lsof -ti:5433
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.