Matthew Hartley Music MCP Server

Matthew Hartley Music — Servidor MCP

El primer servidor MCP propiedad de un artista. Descubre, narra y transmite un álbum continuo, guiado por una historia, desde cualquier cliente de IA que hable el Protocolo de Contexto de Modelo.

Endpoint activo (público, sin autenticación):

https://matthewhartleymusic.com/wp-json/mcp/v1/message

---

Qué es

Este servidor MCP expone The Time Is Now: A Journey in Chapters — el álbum debut de Matthew Hartley — como una experiencia estructurada y nativa para IA. Doce canciones en seis capítulos, cada una con letras, narrativa emocional, grabaciones de versiones y enlaces directos de transmisión. Diseñado para que cualquier cliente de IA pueda:

• Descubrir el catálogo — listar canciones y capítulos con metadatos enriquecidos
• Contar la historia detrás de cada canción — narrativas cortas y completas, letras, etiquetas de estado de ánimo
• Curar una experiencia de escucha secuenciada — seis modos de escucha (late_night, devotional, acoustic_focus, cinematic, quiet_listening, full_journey) con directivas de escena para presentación visual
• Transmitir el audio directamente — URLs firmadas y actualizadas de Cloudflare R2 generadas bajo demanda, ~4 horas de vida útil con una herramienta de actualización para mantener la reproducción ininterrumpida

---

Instalación rápida

Claude Desktop

Agregar a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "matthew-hartley-music": {
      "type": "http",
      "url": "https://matthewhartleymusic.com/wp-json/mcp/v1/message"
    }
  }
}

Reinicia Claude Desktop. El servidor aparece en tu lista de herramientas.

Claude Code (CLI)

claude mcp add matthew-hartley-music https://matthewhartleymusic.com/wp-json/mcp/v1/message

Probar la conexión

curl -X POST https://matthewhartleymusic.com/wp-json/mcp/v1/message \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Deberías recibir un JSON listando las 8 herramientas.

---

Herramientas

Herramienta	Propósito
list_songs	Listar todas las canciones (filtrar por slug de capítulo o estado de lanzamiento)
get_song	Obtener una canción por ID o slug — letras, citas, portada, enlaces de transmisión, asignación de capítulo
list_chapters	Listar todos los capítulos con numeral, nombre, rango de años, etiquetas de estado de ánimo, conteo de canciones
get_chapter	Obtener un capítulo con todas las canciones y la narrativa completa de ACF
get_artist	Perfil del artista + contexto biográfico
get_experience	Lista de reproducción curada de una sola vez para un modo de escucha — canciones, escenas, URLs de transmisión actualizadas
get_experience_prompt	Devuelve la plantilla de indicaciones de narración que los agentes de IA usan para conducir sesiones de escucha
refresh_stream_urls	Generar URLs de audio firmadas y actualizadas en lote, antes de que expiren las URLs existentes

Todas las herramientas devuelven respuestas JSON-RPC 2.0. Las canciones con capacidad de transmisión controlan la transmisión por release_status; las narrativas de capítulo controlan por chapter_released.

---

Ejemplos de indicaciones para probar

Después de instalar, pregúntale a Claude:

"Enumera las canciones de Matthew Hartley y cuéntame la historia detrás de 'Heaven's Calling'."

"Constrúyeme una experiencia de quiet_listening usando la herramienta get_experience. Luego nárrala como un cuentacuentos presentando cada canción."

"¿Cuál es el recorrido de su álbum, capítulo por capítulo?"

"Reprodúceme el Capítulo VI y explica qué cambió en su vida durante esa temporada."

La herramienta get_experience es la llamada de mayor impacto — una solicitud devuelve una lista de reproducción completamente secuenciada con URLs de transmisión y pistas visuales de escena, lista para una sesión de escucha.

---

El reproductor de referencia

Un reproductor de navegador dedicado está construido directamente sobre este MCP:

Reproductor Multimedia Harmonic Wave Experience — Una experiencia de escucha cinematográfica y reactiva al audio con voces en off de DJ, superposiciones de letras sincronizadas LRC y paletas visuales por canción. Nada que instalar — solo abre y escucha.

---

Arquitectura

┌─────────────────────────────┐
│  Any AI client (Claude,     │
│  ChatGPT, Cursor, etc.)     │
└────────────┬────────────────┘
             │ JSON-RPC over HTTP
             ▼
┌─────────────────────────────┐
│ matthewhartleymusic.com     │
│ /wp-json/mcp/v1/message     │
│ (WordPress mu-plugin)       │
└────────────┬────────────────┘
             │ signs URLs at request time
             ▼
┌─────────────────────────────┐
│  Cloudflare R2              │
│  (private bucket — signed   │
│   URLs only, 4-hour TTL)    │
└─────────────────────────────┘

• WordPress aloja el catálogo (tipos de publicación personalizados song y artist, taxonomía chapter, campos ACF para letras/historias/enlaces de transmisión)
• Los archivos de audio residen en un bucket privado de Cloudflare R2, accedidos mediante URLs prefirmadas AWS Sig V4 generadas bajo demanda
• El endpoint MCP es completamente público — no se requiere autenticación. La transmisión por canción está controlada del lado del servidor por el estado de lanzamiento.

---

Acerca de Matthew Hartley

Matthew Hartley es un compositor de rock cristiano de Sarasota, FL — y un veterano de la industria del software con más de 25 años cuya carrera abarca ingeniería, arquitectura, ventas y liderazgo ejecutivo, con múltiples solicitudes de patente USPTO a su nombre. Lidera Imagine Peak Studios, el estudio detrás de este MCP y la plataforma Harmonic Wave. The Time Is Now: A Journey in Chapters es un álbum de doce canciones escrito a lo largo de veinticinco años (1999–2026) — seis capítulos que trazan la inocencia y el desamor, el despertar, romper el ciclo, el amor y el compromiso, el colapso y el llamado, y la fe arraigada.

• Sitio web: matthewhartleymusic.com
• Reproductor de experiencia: experience.matthewhartleymusic.com
• Spotify, Apple Music, YouTube, SoundCloud: todos enlazados por canción en las respuestas MCP

---

Impulsado por Harmonic Wave

Este servidor está construido sobre la plataforma Harmonic Wave — para creadores de contenido que hacen su trabajo nativo para IA.

La plataforma también incluye un plugin de Harmonic Wave para Claude Code que convierte indicaciones en reproductores multimedia personalizados para catálogos en la plataforma.

---

Licencia

La documentación en este repositorio está licenciada bajo la Licencia Apache 2.0. El código fuente del mu-plugin de WordPress del servidor MCP es propietario y no está incluido en este repositorio. La música, letras, contenido de historias y grabaciones de audio expuestas por el MCP son © Imagine Peak Studios — todos los derechos reservados.