Skip to content

Tool Reference

Complete reference for all Massu AI MCP tools with parameters, tier requirements, and descriptions


Tool Reference

Complete reference for all Massu AI MCP tools. Tools are prefixed with your configured toolPrefix (default: massu). Each tool requires a minimum license tier -- Free tools are available to everyone, while Pro, Team, and Enterprise tools require a paid subscription.

License Status Tool

ToolTierDescriptionRequired Params
massu_license_statusFreeShow current license tier, expiry, features, and upgrade options(none)

This tool is always available regardless of tier. See License and Tiers for full tier details.

Knowledge Tools (12)

ToolTierDescriptionRequired Params
massu_knowledge_searchProFull-text search across all knowledge types (rules, incidents, patterns, verifications)query: string
massu_knowledge_ruleProStore or retrieve a coding ruleaction: string (get\set\list)
massu_knowledge_incidentProRecord or query a past incidentaction: string (get\record\list)
massu_knowledge_schema_checkProRecord or retrieve schema validation findingsaction: string (get\record\list)
massu_knowledge_patternProCapture or retrieve a reusable development patternaction: string (get\save\list)
massu_knowledge_verificationProTrack a verification resultaction: string (get\record\list)
massu_knowledge_graphProExplore cross-references between knowledge entriesentry_id: string
massu_knowledge_commandProSurface relevant commands for a given contextcontext: string
massu_knowledge_correctProRecord or retrieve an AI correctionaction: string (get\record\list)
massu_knowledge_planProStore or search plan documentsaction: string (get\save\search)
massu_knowledge_gapsProIdentify knowledge coverage gaps(none)
massu_knowledge_effectivenessProMeasure knowledge utilization and effectiveness(none)

Memory Tools (6)

ToolTierDescriptionRequired Params
massu_memory_searchFreeFull-text search across past observationsquery: string
massu_memory_timelineProChronological context around an observationobservation_id: number
massu_memory_detailProFull observation details by IDsids: number[]
massu_memory_sessionsProList recent sessions with summaries(none)
massu_memory_failuresProGet all failed attempts (DO NOT RETRY)(none)
massu_memory_ingestFreeManually add an observationtype: string, title: string

Code Intelligence Tools (7)

ToolTierDescriptionRequired Params
massu_syncFreeForce rebuild all indexes(none)
massu_contextFreeGet file context (rules, imports, domain)file: string
massu_trpc_map*FreeMap tRPC procedures to UI call sites(none)
massu_coupling_check*FreeFind uncoupled procedures and orphan components(none)
massu_impactFreeFull impact analysis for a filefile: string
massu_domains**FreeDomain boundary information(none)
massu_schema*FreePrisma schema cross-reference(none)

\* Only available when framework.router: trpc \\ Only available when domains is non-empty \\\* Only available when framework.orm: prisma

Feature Registry Tools (6)

ToolTierDescriptionRequired Params
massu_sentinel_searchTeamSearch feature registry(none)
massu_sentinel_detailTeamGet full feature detailsfeature_key or feature_id
massu_sentinel_impactTeamPre-deletion impact analysisfiles: string[]
massu_sentinel_validateTeamValidate all features have living files(none)
massu_sentinel_registerTeamRegister or update a featurefeature_key: string, title: string
massu_sentinel_parityTeamCheck feature parity across portals(none)

Governance Tools (8)

ToolTierDescriptionRequired Params
massu_audit_logEnterpriseQuery the audit trail(none)
massu_audit_reportEnterpriseGenerate audit report(none)
massu_audit_chainEnterpriseView complete audit chain for a filefile_path: string
massu_validation_checkProValidate a file against rulesfile: string
massu_validation_reportProAggregate validation report(none)
massu_adr_listProList architecture decision records(none)
massu_adr_detailProGet full ADR detailsadr_id: number
massu_adr_createProCreate an ADRtitle: string, context: string, decision: string

Security Tools (5)

ToolTierDescriptionRequired Params
massu_security_scoreEnterpriseScan file for security vulnerabilitiesfile: string
massu_security_heatmapEnterpriseSecurity risk heatmap across codebase(none)
massu_security_trendEnterpriseSecurity score trends over time(none)
massu_dep_scoreEnterpriseDependency risk analysispackage_name: string
massu_dep_alternativesEnterpriseSuggest safer dependency alternativespackage_name: string

Analytics Tools (8)

Quality (3)

ToolTierDescriptionRequired Params
massu_quality_scoreProCalculate quality score for session(none)
massu_quality_trendProQuality scores over time(none)
massu_quality_reportProComprehensive quality report(none)

Cost Tracking (3)

ToolTierDescriptionRequired Params
massu_cost_sessionProCost breakdown for a session(none)
massu_cost_trendProCost trends over time(none)
massu_cost_featureProCost attribution by feature(none)

Prompt Effectiveness (2)

ToolTierDescriptionRequired Params
massu_prompt_effectivenessProAnalyze prompt success rates(none)
massu_prompt_suggestionsProGet prompt improvement suggestions(none)

Observability Tools (4)

ToolTierDescriptionRequired Params
massu_session_replayProReplay past session conversationsession_id: string
massu_prompt_analysisProSearch and analyze prompts(none)
massu_tool_patternsProAnalyze tool usage patterns(none)
massu_session_statsProPer-session statistics(none)

Documentation Tools (2)

ToolTierDescriptionRequired Params
massu_docs_auditProAudit docs freshness against code changes(none)
massu_docs_coverageProMeasure documentation coverage(none)

Enterprise Tools (5)

Team Knowledge (3)

ToolTierDescriptionRequired Params
massu_team_searchTeamSearch team knowledge graph(none)
massu_team_expertiseTeamView developer expertise scores(none)
massu_team_conflictsTeamDetect concurrent edit conflicts(none)

Regression Detection (2)

ToolTierDescriptionRequired Params
massu_feature_healthFreeFeature health scores(none)
massu_regression_riskFreeIdentify regression risk(none)

Python Intelligence Tools (8)

All Python tools require a Pro license and only appear in Claude Code when python.root is configured in massu.config.yaml. See Python Code Intelligence for full usage examples.

ToolTierDescriptionRequired Params
massu_py_importsProQuery Python import graph (who imports what, transitive deps)(none)
massu_py_routesProList FastAPI route endpoints with auth and coupling status(none)
massu_py_couplingProShow frontend-to-backend API coupling map(none)
massu_py_modelsProList SQLAlchemy models, columns, relationships, and FK graph(none)
massu_py_migrationsProList Alembic migrations, show chain, detect model/migration drift(none)
massu_py_domainsProCheck Python package domain boundary violations(none)
massu_py_impactProAnalyze impact of changes to a Python filefile: string
massu_py_contextProGet full context for a Python file (rules, imports, routes, models, domain)file: string

Input Schema Details

massu_py_imports

ParameterTypeRequiredDescription
filestringnoShow imports from this file
imported_bystringnoShow files that import this file
transitivebooleannoInclude transitive imports
depthnumbernoMax depth for transitive traversal (default: 5)

massu_py_routes

ParameterTypeRequiredDescription
methodstringnoFilter by HTTP method (GET, POST, PUT, DELETE, PATCH)
pathstringnoFilter by path prefix
filestringnoShow only routes defined in this file
unauthenticatedbooleannoShow only routes with no auth dependencies
uncoupledbooleannoShow only routes with no detected frontend callers
limitnumbernoMax results to return (default: 500, max: 5000)

massu_py_coupling

ParameterTypeRequiredDescription
frontend_filestringnoShow only callers from this frontend file
backend_pathstringnoShow callers for this backend path

massu_py_models

ParameterTypeRequiredDescription
modelstringnoShow details for a specific model class
tablestringnoLook up model by database table name
fk_graphbooleannoShow full foreign key graph between all tables
verify_filestringnoCheck column references in this file against actual schema
limitnumbernoMax results to return (default: 500, max: 5000)

massu_py_migrations

ParameterTypeRequiredDescription
revisionstringnoShow details for a specific revision ID
chainbooleannoShow full migration chain from initial to head
driftbooleannoCompare SQLAlchemy models vs migration state to detect drift
limitnumbernoMax results to return (default: 500, max: 5000)

massu_py_domains

ParameterTypeRequiredDescription
filestringnoClassify this file into a domain
crossingsbooleannoShow all cross-domain imports and violations
domainstringnoList all files in this domain

massu_py_impact

ParameterTypeRequiredDescription
filestringyesPython file path relative to project root

massu_py_context

ParameterTypeRequiredDescription
filestringyesPython file path relative to project root

Tool Naming Convention

All tools follow the pattern: {prefix}{category}{action}

  • Prefix: Configured via toolPrefix (default: massu)
  • Category: The tool group (memory, sentinel, security, etc.)
  • Action: What the tool does (search, score, check, etc.)

Example: massu_memory_search = prefix(massu) + category(memory) + action(search)