Skip to content

Usage en

Daisuke Tsukada edited this page Mar 19, 2026 · 1 revision

Usage & Examples

Once MaxRefMCP is connected to your AI client, simply ask questions about Max/MSP in natural language — the appropriate tools will be invoked automatically.


Basic Usage

You don't need to specify tool names. The AI selects the best tool based on the content of your question.

Look Up Objects

"Tell me about cycle~"
→ maxref.get_object is called

"List MSP filter objects"
→ maxref.search_object is called (domain: "msp", category: "filter")

Compare Objects

"What's the difference between groove~ and play~?"
→ maxref.compare_objects is called

"How do I connect cycle~ to ezdac~?"
→ maxref.explain_connection is called

Patch Design Consultation

"I want to build a synthesizer — what's a good architecture?"
→ maxref.suggest_approach is called

"Find FM synthesis patch patterns"
→ maxref.search_pattern is called

Look Up Terminology

"What is a bang?"
→ maxref.glossary is called

"What's the difference between signal and message?"
→ maxref.glossary is called

Use Cases

1. Learning & Getting Started

Quickly look up object specifications and terminology when you're just getting started with Max/MSP.

"I'm new to Max/MSP — what are the essential objects I should know?"
"What do the different patch cord colors mean?"
"Show me a simple synth setup for learning"

2. Patch Design & Brainstorming

Compare different implementation approaches before you start building.

"I want to build a polyphonic synth. Compare using poly~ vs. mc. objects"
"How can I implement a real-time effect with low CPU usage? Constraint: Max for Live"

3. Pre-Export RNBO Compatibility Check

Batch-check compatibility before exporting your patch to RNBO.

"Can I use cycle~, groove~, js, and coll in RNBO?"
→ Alternatives are suggested for any unsupported objects

4. External Package Selection

Find third-party packages that match your needs.

"Find packages for spatial audio"
"I want to use machine learning in Max. What packages are available?"

Working with MaxMCP

MaxRefMCP handles research and design, while MaxMCP handles hands-on patch operations.

With both connected, you can go from research to implementation seamlessly with AI assistance.

1. "Show me design patterns for an FM synth"     → MaxRefMCP responds
2. "Now build that patch for me"                  → MaxMCP constructs the patch

Clone this wiki locally