PickiPedia integration for magent - traditional music knowledge base

[magent-cryptograss]

Overview

Integrate PickiPedia (traditional music encyclopedia) as a knowledge source accessible to magent during conversations.

What is PickiPedia?

PickiPedia is an encyclopedia of traditional music knowledge - songs, tunes, musicians, history, technique, and lore. Having access to this would let magent provide informed context about:

• Song origins and history
• Traditional variations and versions
• Notable recordings and performers
• Tunings, keys, and technical details
• Regional styles and traditions
• Connections between songs and musicians

Integration Options

Option A: MCP Server

Create an MCP server that exposes PickiPedia data:

Tools:
- search_pickipedia(query) - Full-text search
- get_song(name) - Detailed song info
- get_musician(name) - Musician biography
- get_tune_family(name) - Related tunes
- random_fact() - Serendipitous discovery

Option B: RAG Pipeline

• Index PickiPedia content in vector database
• Query during conversations for relevant context
• Include in responses when discussing traditional music

Option C: Direct Database Access

• Connect to PickiPedia database from magent's container
• SQL queries for structured lookups
• May be simpler than full MCP/RAG setup

Questions to Answer

1. Where does PickiPedia data currently live?
2. What format is it in? (Database, markdown, JSON?)
3. What's the licensing/usage situation?
4. How often is it updated?
5. What's the scope? (Bluegrass only? All traditional?)

Use Cases

During Conversations

• "What's the history of 'Shady Grove'?"
• "Who wrote 'Blue Railroad Train'?"
• "What key is 'Salt Creek' usually played in?"
• "Tell me about the Carter Family scratch"

During Show Documentation

• Auto-linking songs to PickiPedia entries
• Providing historical context in show pages
• Connecting songs to their traditional roots

For Chartifacts

• Adding historical metadata to studio charts
• Noting traditional variations in arrangements

Technical Considerations

• Latency: Need fast lookups for conversational use
• Scope: What subset of PickiPedia is most relevant?
• Updates: How to keep in sync with PickiPedia changes?
• Authentication: Any API keys or access control?

Files Likely Involved

• New MCP server (if Option A): magenta/pickipedia-mcp/
• Claude config: ~/.claude/settings.local.json (add MCP)
• CLAUDE.md: Document new capability

Acceptance Criteria

• PickiPedia data accessible from magent sessions
• Can query song information during conversations
• Integration documented in CLAUDE.md
• Latency acceptable for interactive use
• Clear attribution to PickiPedia in responses

Labels

enhancement, ai-capability, lone-star-release