MCP Tools

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:

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:

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

Tool not found

Ensure the MCP server is configured in your Claude Code settings. Check that the soundcheck MCP server is listed and active.

Docker not running

npm run dev:infra and database tools need Docker. Start Docker before bringing up shared infra.

Port conflicts

lsof -ti:4000
lsof -ti:5433

Overview

Backend

Backend integrations

API reference

Frontend

Mobile

Infrastructure

CI/CD

Development

Guides

Reference

Overview

Available tools

Database

Mobile app

Example usage

Database setup

Default local ports

Manual equivalents

Troubleshooting

​Overview

​Available tools

​Database

​Mobile app

​Example usage

​Database setup

​Default local ports

​Manual equivalents

​Troubleshooting

Overview

Available tools

Database

Mobile app

Example usage

Database setup

Default local ports

Manual equivalents

Troubleshooting