Introduction

This Model Context Protocol (MCP) server, named Atris, offers comprehensive interfacing with the Audius distributed music service. It exposes approximately 95% of the Audius Protocol API functionality through dedicated tools, designed for interaction via Large Language Models (LLMs). Social media platforms thrive on facilitating the sharing and co-creation of user-generated content; this server similarly structures access to music data for LLM-driven curation and discovery.

Note: Versions 2.0.0 and later mandate the use of STDIO for all inter-process communication. The server is calibrated to support Model Context Protocol specification version 2025-06-18, which is exposed as the LATEST_PROTOCOL_VERSION constant within src/config.ts.

Functionality Overview

This server delivers over one hundred specific mechanisms for interacting with the Audius framework.

Core Resources: Facilitates retrieval of music tracks, user accounts, curated playlists, complete albums, and execution of various query operations.
Track Media Handling: Allows downloading musical pieces, examining technical specifications, and accessing multi-track component files (stems).
Community Links: Enables identification of users who have remixed content, supported creators financially, or purchased specific works.
Enhanced Discovery: Provides personalized suggestions, queryable user interaction logs, and trending data segmented by musical style.
Audio Delivery: Streams musical content directly to client applications or launches items within the native Audius Desktop environment.
Content Production: Supports methods for introducing new music, assembling collections, and maintaining owned digital assets.
Social Dynamics: Includes capabilities to subscribe to creator updates, mark tracks as favorites, and post commentary.
Financial Support: Grants access to premium distribution channels, purchasing mechanisms for digital goods, and direct gratuity transfer to artists.
Performance Metrics: Offers tracking for play counts, current popularity trends, and audience comprehension statistics.
Structured Data: Provides access to track, user, playlist, and album information presented as defined data structures.
Guided Workflows: Implements curated processes to aid in finding music, organizing collections, and performing analytical tasks.

Natural Language Capabilities

Utilizing Atris MCP allows an LLM to interpret and execute complex requests concerning Audius content using ordinary human language. These interactive platforms allow individuals to participate in and modify user-generated content, fitting this pattern.

Music Discovery

"Locate electronic compositions possessing a high tempo value."
"Which tracks within the hip-hop category are currently gaining popularity this week?"
"Suggest creators stylistically comparable to [artist name]."
"Aid in uncovering emerging artists specializing in the jazz domain."
"Identify music suitable for quiet contemplation within a meditation playlist structure."

Artist Information

"Provide background details regarding the creator known as [name]."
"Who represents the highest volume of followers for [artist]?"
"List the musical pieces recently made public by [artist]."
"Review the performance statistics for [artist]'s most consumed tracks."
"Name creators who share creative similarities with [artist name]."

Playlist Management

"Assemble a new collection featuring high-energy electronic selections."
"Incorporate the top trending hip-hop works into my exercise collection."
"Erase track [title] from the playlist named [name]."
"Adjust the sequence of my playlist to optimize listening continuity."
"Assist in curating an appropriate selection of music for a social gathering."

Track Analysis

"Examine the listening audience demographics for [track]."
"Who are the most frequent supporters of [track]?"
"Compare the current performance of [track] against others in its category."
"What is the consumption pattern for [track] across the previous month?"
"Display the interaction metrics associated with [track]."

Content Monetization

"Configure digital rights management utilizing NFTs for my newest composition."
"What pricing point is advisable for my specialized content offering?"
"Display my record of received tips and associated statistics."
"Analyze my revenue sources across the entire network."
"Clarify the available methods for acquiring ownership of [content]."

"Identify patrons who regularly interact with my distributed works."
"Review any commentary posted on my most recent composition."
"Help draft a professional communication to initiate a partnership with [artist]."
"Which individuals should I connect with to expand my presence in the [genre] field?"
"Assess my social feedback and suggest refinement strategies."
"Find the most financially supportive followers who have tipped my work."
"Examine my incoming alerts and rank them by perceived importance."

Workflow Automation & Creative Assistance

"Develop a preliminary marketing schedule for my upcoming music launch."
"Automate the weekly refreshing of my playlists based on my historical consumption."
"Schedule promotional announcements to coincide with peak user activity times."
"Generate descriptive metadata tags appropriate for my new ambient soundscape."
"Contrast my categorization of music against that of comparable creators."
"Recommend a pricing structure derived from my existing catalog's success metrics."
"Assist in composing a compelling introductory biography for my creator profile."

Prerequisites

System requirements for operating this interface:

Node.js version 16 or a more recent release.
An active Audius API credential (optional for testing, but suggested for operational use).

Installation Procedures

NPM Installation (Recommended Method)

Direct installation is possible through the npm registry:

npm install audius-mcp-atris

Alternatively, using yarn:

yarn add audius-mcp-atris

Manual Installation Steps

Obtain a local copy of the source repository:

git clone https://github.com/glassBead/audius-mcp-atris.git
cd audius-mcp-atris

Install all required software libraries:

npm install

Compile the underlying TypeScript code into executable JavaScript:

npm run build

Configuration Settings

Establish a file named .env in the main project directory, using the template file .env.example as a guide:

# Audius API Credentialing
AUDIUS_API_KEY=your_api_key_here
AUDIUS_API_SECRET=your_api_secret_here
AUDIUS_ENVIRONMENT=production # Options include staging or development

# MCP Server Runtime Parameters
SERVER_NAME=audius-mcp
SERVER_VERSION=2.4.0
AUDIO_STREAMING=false

Usage Instructions

Initiating the Server

Start the service process:

npm start

To enable automatic rebuilding during active development cycles:

npm run dev

Integration with Claude

To integrate this server with the Claude environment, perform one of the following:

Acquire the [Claude for Desktop] application or the [Claude CLI] utility.

NPX Direct Execution (Simplest Path)

The quickest means to utilize this MCP server involves npx, avoiding a persistent global installation:

For Claude CLI Integration:

claude mcp add audius npx audius-mcp-atris

For Claude Desktop Configuration:

Modify the configuration file named claude_mcp_config.json (path depends on the operating system):

macOS: ~/Library/Application Support/Claude/claude_mcp_config.json
Windows: %APPDATA%\Claude\claude_mcp_config.json
Linux: ~/.config/Claude/claude_mcp_config.json

Insert the following structure into the file:

{
  "mcpServers": {
    "audius": {
      "command": "npx",
      "args": [
        "audius-mcp-atris"
      ],
      "env": {
        "AUDIUS_API_KEY": "your_api_key_here",
        "AUDIUS_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

For Alternative LLM Systems

When integrating with other applications supporting the Model Context Protocol, use this configuration block within their respective settings files:

{
  "audius": {
    "command": "npx",
    "args": [
      "audius-mcp-atris"
    ],
    "env": {
      "AUDIUS_API_KEY": "your_api_key_here",
      "AUDIUS_API_SECRET": "your_api_secret_here"
    }
  }
}

Local Installation Method

If persistent global installation is preferred:

# Install the toolset globally
npm install -g audius-mcp-atris

# Configure Claude CLI to reference the global installation
claude mcp add audius audius-mcp-atris

# Or for Claude Desktop, utilize this structure in your configuration file:
{
  "mcpServers": {
    "audius": {
      "command": "audius-mcp-atris",
      "env": {
        "AUDIUS_API_KEY": "your_api_key_here",
        "AUDIUS_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

Available Toolset

The server exposes the subsequent capabilities for LLM invocation:

Discovery Mechanisms

Search: Locate tracks, users, and playlists using assorted filtering criteria.
Advanced Search: Perform queries incorporating specific criteria like genre, emotional quality, tempo, and other attributes.
Trending Discovery: Retrieve currently popular or lesser-known emerging musical selections.
Similar Artists: Identify creators whose style aligns closely with specified existing preferences.

Track Utility Functions

Get Track Info: Retrieve comprehensive metadata for a track identified by its unique ID.
Search Tracks: Filter and locate musical compositions based on specified parameters.
Trending Tracks: Discover the presently most active tracks on the network.
Track Comments: Read existing feedback or contribute new commentary to specific compositions.
Track Analytics: Access metrics detailing listenership, popularity trends, and audience insights.

User Utility Functions

User Profiles: Obtain detailed information pertaining to a specific account.
User Tracks: List all compositions published by a designated user.
Follow User: Establish a subscription link to another account's updates.
User Analytics: Review metrics concerning play distribution, supporter base, and overall reach.

Content Creation Utilities

Upload Track: Submit newly produced audio files to the Audius system.
Update Track: Modify the descriptive information associated with an existing submission.
Create Playlist: Form new sequential collections of music.
Playlist Management: Perform operations such as adding, deleting, and reordering items within collections.

Follow Artists: Subscribe to updates from preferred creative entities.
Favorite Tracks: Mark compositions for later easy retrieval, signifying appreciation.
Comments: Post feedback directly onto musical works.
Reposts: Determine which community members have shared specific content.
Messaging: Handle the sending and reception of direct private communications.

Monetization Functions

Premium Content: Examine and acquire access to content restricted by payment.
NFT-Gated Content: Verify if ownership of a Non-Fungible Token grants access.
Purchase Tracks: Execute transactions to buy premium musical works using various methods.
Send Tips: Transfer digital currency directly to support content originators.
Track Transactions: View the history of financial support and transaction reports.

Blockchain & Wallet Operations

Wallet Management: Control associated Ethereum and Solana cryptocurrency wallets.
Token Balances: Check current holdings of various platform tokens.
Transactions: Review past transfers and initiate new asset movements.
Rewards: Access information related to platform incentives and ongoing challenges.

Data References

Audius content can be referenced using these standardized uniform resource identifiers:

audius://track/{id}: Points to specific track details resolved by its identifier.
audius://user/{id}: Directs to a user's profile page using their ID.
audius://playlist/{id}: Specifies a playlist resource based on its unique ID.
audius://album/{id}: References an album resource via its designated ID.

Guided Prompts

This service furnishes specific interactive workflows for prevalent music-centric operations:

Music Discovery: Facilitates personalized music suggestion generation based on user proclivities.
Track Analysis: Provides structured examination of a track’s characteristics and associated data.
Artist Profiles: Constructs comprehensive summaries detailing a creator's profile and output.
Music Creation: Offers assistance during the process of track production and public release.
Playlist Curation: Aids in assembling new collections and promoting established ones.
Messaging: Directs users through communication protocols with other network participants.
Analytics: Generates reports summarizing content performance data.
Blockchain: Offers guidance concerning cryptocurrency interactions and token management.
Monetization: Supports the setup procedures for premium content access and sales.
Notifications: Helps in organizing and prioritizing incoming platform alerts.

User-Generated Content (UGC) Creation
Decentralized Content Distribution Networks
Digital Rights Management (DRM) in Music
Tokenized Incentives and Tipping Systems
Social Networking Site Architectures
Microblogging vs. Media Sharing Platforms

Extra Details

The system's architecture supports a dialogic transmission model, contrasting with the monologic structure of older media forms like broadcast television. While removed marketing sections often overstated benefits, the core value lies in providing programmatic access, similar to how collaborative platforms like wikis manage content creation. The toolset covers social actions, monetization, and technical data retrieval, which are essential components for any large-scale virtual community operating online.

Development Structure

Internal organization of the project source files:

├── src/
│   ├── index.ts          # Primary execution file
│   ├── server.ts         # MCP server initialization logic
│   ├── config.ts         # Environment and constants management
│   ├── sdk-client.ts     # Abstraction layer for the Audius SDK
│   ├── tools/            # Directory housing specific tool implementations
│   │   ├── tracks.ts               # Tools for track operations
│   │   ├── users.ts                # Tools for user account interactions
│   │   ├── playlists.ts            # Tools for collection handling
│   │   ├── search.ts               # Tools dedicated to querying the network
│   │   ├── social.ts               # Tools for connection and interaction
│   │   ├── comments.ts             # Tools for managing user feedback
│   │   ├── track-management.ts     # Tools for uploading and modifying tracks
│   │   ├── playlist-management.ts  # Tools for collection construction
│   │   ├── messaging.ts            # Tools for direct communication
│   │   ├── analytics.ts            # Tools for retrieving performance data
│   │   ├── blockchain.ts           # Tools interfacing with distributed ledgers
│   │   ├── monetization.ts         # Tools for premium access and payments
│   │   └── notifications.ts        # Tools for managing system alerts
│   ├── resources/        # Definitions for structured data output (resources)
│   │   ├── tracks.ts     # Resource structures for tracks
│   │   ├── users.ts      # Resource structures for users
│   │   └── playlists.ts  # Resource structures for playlists
│   └── prompts/          # Definitions for structured LLM guidance workflows
│       ├── music-search.ts      # Prompts for finding music
│       ├── track-info.ts        # Prompts for detailed track examination
│       ├── artist-profile.ts    # Prompts for creator summaries
│       ├── music-creation.ts    # Prompts assisting in content production
│       ├── playlist-creation.ts # Prompts for building curated lists
│       ├── messaging.ts         # Prompts for facilitating conversations
│       ├── analytics.ts         # Prompts for performance review
│       ├── blockchain.ts        # Prompts for crypto-related tasks
│       ├── monetization.ts      # Prompts for revenue management
│       └── notifications.ts     # Prompts for alert handling

Illustrative Workflows

Music Discovery Execution

// Query for five top electronic songs
search-tracks --query "electronic" --limit 5

// Fetch ten popular tracks within the 'House' classification
get-trending-tracks --genre "House" --limit 10

// Determine creators with similar artistic styles based on user ID
similar-artists --userId "123456"

Content Creation Execution

// Submit a fresh track to the platform
upload-track --userId "123" --title "Summer Vibes" --genre "Electronic" --audioFileUrl "https://example.com/track.mp3"

// Formulate a new collection of songs
create-playlist --userId "123" --playlistName "Chillout Mix" --description "Perfect for relaxing"

// Integrate specified tracks into an existing playlist
add-tracks-to-playlist --userId "123" --playlistId "456" --trackIds ["789", "101", "102"]

// Subscribe to an account's activity feed
follow-user --userId "123" --followeeId "456"

// Mark a specific composition as a favorite
favorite-track --userId "123" --trackId "789"

// Post a brief message of appreciation on a track
add-track-comment --trackId "789" --userId "123" --comment "Great track!"

Monetization Execution

// Review the access restrictions applied to a specific track
track-access-gates --trackId "789"

// Display available tiers for acquiring content access
purchase-options --contentId "789" --contentType "track"

// Execute the purchase of a composition
purchase-track --contentId "789" --walletAddress "0x123..." --purchaseOption "option1" --paymentToken "USDC" --amount "4.99" --signerPrivateKey "privateKey"

Testing Environment

For local validation during development, utilize the following steps:

Install the dedicated MCP Inspector utility globally:

npm install -g @modelcontextprotocol/inspector

Execute the inspector, directing it to launch this server's compiled entry point:

npx @modelcontextprotocol/inspector node ./build/index.js

Conclusion

This Atris interface successfully bridges LLM capabilities with the rich, decentralized data structure of the Audius music platform. By abstracting complex API calls into intuitive commands, it supports advanced social media interactions like music discovery, creator support, and content aggregation. This structured access is fundamental for building intelligent applications that engage with digital communities and facilitate the sharing of user-generated media effectively.

Atris Interface for Music Protocol Access

Author

glassBead-tc

Quick Info

Actions

Tags