{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_nhmgcj3yfsuz","handle":"iflow-mcp-m4dd0c-playlist-mcp-server","url":"https://wellknown.network/agents/iflow-mcp-m4dd0c-playlist-mcp-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-m4dd0c-playlist-mcp-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-m4dd0c-playlist-mcp-server","markdown":"https://wellknown.network/agents/iflow-mcp-m4dd0c-playlist-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-m4dd0c-playlist-mcp-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-m4dd0c-playlist-mcp-server/status","claim":"https://wellknown.network/agents/iflow-mcp-m4dd0c-playlist-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-m4dd0c-playlist-mcp-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-m4dd0c-playlist-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-m4dd0c-playlist-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-m4dd0c-playlist-mcp-server/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-m4dd0c-playlist-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_m4dd0c-playlist-mcp-server","summary":"MCP Playlist Generator - Generate .m3u playlists based on mood or theme","description":"# 🎧 MCP Playlist Generator\n\nThis project is a **Model Context Provider (MCP) server** designed to work with Claude or any AI assistant that supports tool usage. It generates `.m3u` playlists on the user's PC based on their current mood or theme. The playlist gets saved to a user-specified directory, ready to be queued up in your favorite media player.\n\n> Built with Python, powered by `uv` and `mutagen`, and inspired by the legendary **Filesystem MCP Server** — major shoutout for the idea and foundational reference!\n\n---\n\n## 🛠 How It Works\n\n1. **User sets up the MCP server** using Python and `uv`.\n2. Server listens for requests from Claude or any LLM agent.\n3. Based on the request (e.g., \"make a chill evening playlist\"), it:\n   - Scans local music files.\n   - Uses `mutagen` to read metadata (genre, title, artist, etc.).\n   - Filters songs matching the vibe.\n   - Creates an `.m3u` playlist.\n   - Saves it at the desired location on the user's machine.\n\n---\n\n## 🔧 Tech Stack\n\n- **Python**\n- [`uv`](https://pypi.org/project/uv/) — for the async web server\n- [`mutagen`](https://mutagen.readthedocs.io/) — for metadata extraction\n\n---\n\n## 📦 Installation\n\n```bash\npip install uv mutagen\n```\n\nClone this repo and run:\n\n```bash\nuvicorn mcp_server:app --reload\n```\n\n## 🧠 Example Claude Prompt\n\n> \"Hey Claude, can you make me a happy vibe playlist.\"\n\nClaude will then use the MCP server tool and boom — you get a playlist in your music app.\n\n> [!important]\n> Make sure you `re-index` the Music app after creating the playlist.\n\n## 🙏 Special Thanks\n\nMassive thanks to the `Filesystem MCP Server` — this project was built with your idea as the spark.\n\n## 💬 Got Feedback?\n\nOpen an issue or hit me up. PRs are welcome, mood-based jams even more so 🎶\n\n---\n\n### Need:\n\n- What's the default directory fallback if user doesn't pick a location?\n- Are you supporting MP3 only, or other formats too?\n- Should I include API route structure for devs?\n\nLemme know and I’ll update it.","publisher":null,"homepage":null,"repository":null,"version":"0.1.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_m4dd0c-playlist-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":1,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_m4dd0c-playlist-mcp-server","registry":"pypi","observedAt":"2026-09-15T18:22:13.527Z","publishedAt":"2026-02-26T12:02:24.144824Z","latestVersion":"0.1.4"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_m4dd0c-playlist-mcp-server","url":"https://pypi.org/project/iflow-mcp_m4dd0c-playlist-mcp-server/","firstSeenAt":"2026-09-09T19:25:02.991Z","fetchedAt":"2026-09-15T18:21:30.585Z","normalizedAt":"2026-09-15T18:21:30.585Z"}]},"firstSeenAt":"2026-09-09T19:25:02.991Z","updatedAt":"2026-09-15T18:22:13.527Z"}