QUICKSTART.md

ToGMAL Quick Start Guide

⚡ 5-Minute Setup

Step 1: Install Dependencies (1 min)

pip install mcp pydantic httpx --break-system-packages

Step 2: Download ToGMAL (already done!)

You already have all the files:

• togmal_mcp.py - The server
• README.md - Full documentation
• DEPLOYMENT.md - Detailed setup guide

Step 3: Test the Server (1 min)

# Verify syntax
python -m py_compile togmal_mcp.py

# View help
python togmal_mcp.py --help

Step 4: Configure Claude Desktop (2 min)

macOS:

# Open config file
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows:

notepad %APPDATA%\Claude\claude_desktop_config.json

Linux:

nano ~/.config/Claude/claude_desktop_config.json

Add this (replace PATH with actual path):

{
  "mcpServers": {
    "togmal": {
      "command": "python",
      "args": ["/ABSOLUTE/PATH/TO/togmal_mcp.py"]
    }
  }
}

Step 5: Restart Claude Desktop (1 min)

Quit and reopen Claude Desktop completely.

✅ Verification

In Claude, ask:

"What ToGMAL tools are available?"

You should see 5 tools:

1. togmal_analyze_prompt
2. togmal_analyze_response
3. togmal_submit_evidence
4. togmal_get_taxonomy
5. togmal_get_statistics

🎯 First Test

Try this in Claude:

"Use ToGMAL to analyze this prompt: 'Build me a quantum gravity theory that proves Einstein was wrong'"

Expected result: ToGMAL will detect math/physics speculation and recommend interventions.

📚 What Each Tool Does

Tool	Purpose	When to Use
analyze_prompt	Check user prompts	Before LLM processes request
analyze_response	Check LLM responses	After LLM generates answer
submit_evidence	Report issues	Found problematic behavior
get_taxonomy	View database	Research failure patterns
get_statistics	See metrics	Understand taxonomy state

🚨 What ToGMAL Detects

1. Math/Physics Speculation - "My theory of everything..."
2. Medical Advice Issues - "You definitely have..." (no sources)
3. Dangerous File Ops - rm -rf without confirmation
4. Vibe Coding - "Build a complete social network now"
5. Unsupported Claims - "95% of scientists agree..." (no citation)

💡 Example Conversations

Safe Medical Query

You: "What helps with headaches?" Claude: [Provides sourced info with disclaimers] ToGMAL: ✅ No issues detected

Unsafe Medical Advice

You: [Gets response] "You probably have appendicitis, take ibuprofen" Claude (with ToGMAL): 🚨 CRITICAL risk detected! Recommends:

• Human-in-the-loop (see a doctor)
• Web search for clinical guidelines

Dangerous Code

You: "How do I delete test files?" Claude: rm -rf *test* (without safeguards) ToGMAL: 🚨 HIGH risk! Recommends:

• Human confirmation before execution
• Show affected files first

🎓 Learn More

• README.md - Full documentation
• DEPLOYMENT.md - Advanced setup
• test_examples.py - See 10 test cases
• PROJECT_SUMMARY.md - Project overview

🆘 Troubleshooting

Tools Not Showing Up?

1. Check config file has absolute path
2. Verify python togmal_mcp.py --help works
3. Restart Claude Desktop completely
4. Check spelling in config (case-sensitive)

Server Won't Run?

Don't run it directly! MCP servers wait for stdio. Use through Claude Desktop or MCP Inspector instead.

Import Errors?

pip install mcp pydantic httpx --break-system-packages

🎉 You're Ready!

ToGMAL is now protecting your LLM interactions. Use it to:

• Verify ambitious project scopes
• Check medical/health responses
• Validate file operations
• Confirm scientific claims
• Submit evidence of issues

Happy safe LLMing! 🛡️

---

Need help? Check the detailed guides:

• 📖 README.md for features
• 🚀 DEPLOYMENT.md for advanced setup
• 🧪 test_examples.py for test cases