Atris MCP for Audius (v2.0.0)

Note: Version 2.0.0+ exclusively uses STDIO transport for all capabilities.

An MCP (Model Context Protocol) server that provides access to the Audius music platform via LLMs (Large Language Models).

Features

• Tools: Access tracks, users, playlists, albums, and perform searches on Audius

• Content Creation: Upload tracks, create playlists, manage your Audius content

• Social Features: Follow users, favorite tracks, comment on content

• Monetization: Access premium content, purchase tracks, send tips to artists

• Analytics: Track play counts, trending data, and listener insights

• Resources: Access track, user, playlist, and album data as structured resources

• Prompts: Use guided experiences for music discovery, curation, and analysis

Natural Language Capabilities

With Atris MCP, you can ask your LLM questions in natural language about Audius content. Examples include:

Music Discovery

• "Find me electronic tracks with a high BPM"

• "What are the trending tracks in the hip-hop genre this week?"

• "Recommend artists similar to [artist name]"

• "Help me discover underground artists in the jazz genre"

• "Find tracks with a relaxing mood for a meditation playlist"

Artist Information

• "Tell me about the artist [name]"

• "Who are the most popular followers of [artist]?"

• "What tracks has [artist] released recently?"

• "Show me the analytics for [artist]'s most popular tracks"

• "Which artists are similar to [artist name]?"

Playlist Management

• "Create a playlist of upbeat electronic tracks"

• "Add the top trending hip-hop tracks to my workout playlist"

• "Remove track [title] from my playlist [name]"

• "Reorder my playlist to create a better flow between songs"

• "Help me curate a playlist for a party"

Track Analysis

• "Analyze the listener demographics for [track]"

• "Who are the top fans of [track]?"

• "How is [track] performing compared to other tracks in its genre?"

• "What's the listening trend for [track] over the past month?"

• "Show me the engagement metrics for [track]"

Content Monetization

• "Set up NFT gating for my new track"

• "How much should I charge for my premium content?"

• "Show me my tipping history and stats"

• "Analyze my revenue streams across the platform"

• "Help me understand the purchase options for [content]"

Social & Community Interactions

• "Find fans who frequently engage with my music"

• "Show me comments on my latest track"

• "Help me compose a message to collaborate with [artist]"

• "Who should I follow to grow my network in the [genre] scene?"

• "Analyze my social engagement and suggest improvements"

• "Find the most supportive fans who've tipped me"

• "Track my notification history and prioritize important ones"

Workflow Automation & Creative Assistance

• "Plan my next track release with a marketing timeline"

• "Automate weekly playlist updates based on my listening habits"

• "Schedule content announcements for optimal engagement"

• "Generate descriptive tags for my new ambient track"

• "Compare my genre categorization to similar artists"

• "Suggest a pricing strategy based on my existing catalog performance"

• "Help me craft an engaging artist bio for my profile"

Prerequisites

• Node.js 16 or higher

• An Audius API key (optional, but recommended for production use)

Installation

NPM Installation (Recommended)

Install directly from npm:

Or with yarn:

Manual Installation

1. Clone this repository:

2. Install dependencies:

3. Build the TypeScript code:

Configuration

Create a .env file in the root directory based on the provided .env.example:

Usage

Running the Server

Start the server:

For development with automatic rebuilding:

Connecting to Claude

To use this server with Claude:

1. Install Claude for Desktop or Claude CLI

NPX Installation (Recommended)

The easiest way to use this MCP server is with npx, which can run the package without installing it globally:

For Claude CLI:

For Claude Desktop:

Edit your claude_mcp_config.json file (location varies by platform):

• macOS: ~/Library/Application Support/Claude/claude_mcp_config.json

• Windows: %APPDATA%\Claude\claude_mcp_config.json

• Linux: ~/.config/Claude/claude_mcp_config.json

Add this configuration:

For Other LLM Applications:

For applications that support Model Context Protocol, use this configuration in their respective config files:

Local Installation Method

If you prefer a local installation:

Available Tools

The server provides the following functionality:

Discovery Tools

• Search: Find tracks, users, playlists with various filters

• Advanced Search: Search with genre, mood, BPM, and other filters

• Trending Discovery: Get trending or underground tracks

• Similar Artists: Find artists similar to those you like

Track Tools

• Get Track Info: Detailed track information by ID

• Search Tracks: Find tracks with various filters

• Trending Tracks: Discover what's hot on Audius

• Track Comments: View and add comments on tracks

• Track Analytics: Listen counts, trending data, audience insights

User Tools

• User Profiles: Get detailed user information

• User Tracks: List tracks uploaded by a user

• Follow User: Follow other users

• User Analytics: Track play metrics, supporters, and more

Content Creation

• Upload Track: Add new tracks to Audius

• Update Track: Modify existing track metadata

• Create Playlist: Build collections of tracks

• Playlist Management: Add, remove, and reorder tracks

Social Interaction

• Follow Artists: Connect with favorite creators

• Favorite Tracks: Save and show appreciation for music

• Comments: Add comments to tracks

• Reposts: See who has reposted content

• Messaging: Send and receive direct messages

Monetization

• Premium Content: Access and purchase gated content

• NFT-Gated Content: Check and verify NFT-based access

• Purchase Tracks: Buy premium content with various payment options

• Send Tips: Support artists directly

• Track Transactions: View tip history and stats

Blockchain & Wallet

• Wallet Management: Manage Ethereum and Solana wallets

• Token Balances: Check cryptocurrency balances

• Transactions: View history and execute transfers

• Rewards: Access Audius platform rewards and challenges

Resources

Access Audius data using these URI templates:

• audius://track/{id}: Track details by ID

• audius://user/{id}: User profile by ID

• audius://playlist/{id}: Playlist details by ID

• audius://album/{id}: Album details by ID

Prompts

The server offers guided experiences for common music-related tasks:

• Music Discovery: Find recommendations based on preferences

• Track Analysis: Analyze track characteristics and get insights

• Artist Profiles: Generate comprehensive artist overviews

• Music Creation: Assist with track creation and publishing

• Playlist Curation: Help with creating and promoting playlists

• Messaging: Guide interactions with other users

• Analytics: Generate reports and insights on music performance

• Blockchain: Assist with crypto and token operations

• Monetization: Guide premium content setup and purchases

• Notifications: Manage and organize platform notifications

Development

Project Structure

Example Workflows

Music Discovery

Content Creation

Social Features

Monetization

Testing

For local development testing:

1. Install the MCP Inspector:

2. Run the inspector with your server:

License

MIT