Introduction

Content creation fundamentally involves producing and distributing information or media, especially in digital environments. This particular utility interfaces with the Audius platform, providing structured access to its decentralized network for music discovery and management. It allows users to interact with material, such as tracks and artist profiles, supporting the goals of digital self-expression and sharing.

Note: Version 2.0.0 and later exclusively employ STDIO transport for all operational facets. The server adheres to Model Context Protocol version 2025-06-18, which is also exposed as LATEST_PROTOCOL_VERSION within src/config.ts.

This Model Context Protocol (MCP) server furnishes extensive programmatic access to the Audius infrastructure. It exposes 105 distinct tools that map to approximately 95% of the underlying Audius Protocol API functionality.

Features

• Toolset: Access musical pieces, profiles, curated lists, and execute targeted searches on Audius.
• Media Handling: Download track files, examine technical specifications, and retrieve component stems.
• Social Mapping: Determine individuals who purchase tracks, create derivative works, or are associated artists.
• Discovery Enhancement: Receive personalized suggestions, review user consumption patterns, and identify genre-specific trending items.
• Direct Audio: Stream musical content straight to your application or launch it within the Audius Desktop client.
• Content Production: Facilitate the submission of new tracks, the assembly of playlists, and general management of your platform assets.
• Community Functions: Connect with users through following actions, marking favored tracks, and posting commentary.
• Revenue Streams: Investigate premium offerings, execute content purchases, and dispatch monetary support to performing artists.
• Performance Metrics: Monitor play counts, observe current popularity trends, and gain listener insights.
• Data Structures: Retrieve track, user, playlist, and album information presented as organized resources.
• Guided Interactions: Utilize structured queries for refining music selection, organizing media, and performing deep analysis.

Natural Language Capabilities

Using the Atris MCP, you can pose questions to your language model concerning Audius items using conversational language. Below are examples illustrating the range of supported inquiries.

Music Discovery

• "Identify electronic compositions exhibiting a high beats-per-minute rating"
• "Which tracks are trending within the hip-hop category this present week?"
• "Suggest recording artists stylistically comparable to [artist name]"
• "Aid in uncovering niche performers within the jazz domain"
• "Locate pieces suitable for a meditation sequence requiring a tranquil ambiance"

Artist Information

• "Provide contextual details regarding the creator [name]"
• "Who constitutes the most followed individuals supporting [artist]?"
• "List the recordings recently published by [artist]?"
• "Present the analytical data associated with [artist]'s most popular creations"
• "Name other creators who share similarities with [artist name]?"

Playlist Management

• "Assemble a collection composed of energetic electronic pieces"
• "Incorporate the leading popular hip-hop selections into my physical training list"
• "Exclude the composition [title] from my collection named [name]"
• "Restructure my compilation sequence to ensure smoother transitions between songs"
• "Assist me in curating a suitable soundtrack for an upcoming social event"

Track Analysis

• "Examine the audience segmentation data related to [track]"
• "Who represents the primary supporters for this specific [track]?"
• "How does the performance of [track] compare against others in its established category?"
• "Display the consumption trajectory for [track] across the preceding thirty days"
• "Detail the engagement statistics observable for [track]"

Content Monetization

• "Institute digital rights management via NFTs for my newest recording"
• "Determine an appropriate valuation for my exclusive content offerings?"
• "Review my history of direct artist support payments and associated metrics"
• "Analyze my derived income streams across the entire platform distribution"
• "Clarify the available methods for acquiring rights to [content]"

Social & Community Interactions

• "Identify platform members who regularly interact with my published works"
• "Review the commentary that has been placed upon my most recent track"
• "Help draft a communication proposing a creative partnership with [artist]"
• "Which profiles should I follow to expand my professional reach within the [genre] community?"
• "Assess my current social involvement and suggest necessary refinements"
• "Locate the most dedicated supporters who have provided financial tips"
• "Trace my record of platform alerts and prioritize the critical notifications"

Workflow Automation & Creative Assistance

• "Draft a timeline for the promotional schedule surrounding my subsequent recording launch"
• "Automate the weekly refreshing of playlists based on my personal listening tendencies"
• "Schedule announcements of new creations for optimal audience reception times"
• "Generate descriptive metadata tags appropriate for my new ambient composition"
• "Contrast my classification of genre against that used by comparable artists"
• "Propose a pricing structure informed by the success metrics of my current catalog"
• "Assist in drafting an appealing personal biography for my creator profile"

Prerequisites

To operate this server, you will need the following:

• Node.js version 16 or a more recent iteration
• An active Audius API authentication key (though optional, this is strongly advised for any deployment beyond testing)

Installation

NPM Installation (Recommended Procedure)

Install the package directly using the npm registry:

npm install audius-mcp-atris

Alternatively, use yarn for package management:

yarn add audius-mcp-atris

Manual Installation Steps

1. Obtain a local copy of the repository source code:

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

1. Install all necessary project dependencies:

npm install

1. Compile the underlying TypeScript source code into executable JavaScript:

npm run build

Configuration

Establish a .env file inside the main project directory, referencing the structure provided in the .env.example file:

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

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

Usage

Launching the Server Process

Initiate the server execution:

npm start

For an environment that rebuilds automatically during coding changes:

npm run dev

Integration with Claude

To employ this server alongside Claude:

1. Obtain and install Claude for Desktop or the Claude CLI

NPX Installation (Most Convenient Option)

The simplest method for utilizing this MCP server involves npx, allowing execution without a persistent global installation:

For Claude CLI Users:

claude mcp add audius npx audius-mcp-atris

For Claude Desktop Users:

Modify the configuration file named claude_mcp_config.json. The precise location depends on your 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

Append this structure to the existing configuration data:

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

For Other LLM Applications

If your application supports the Model Context Protocol standard, integrate this configuration into its specific configuration 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 a global installation is preferred for local execution:

# Install the package globally across the system
npm install -g audius-mcp-atris

# Then, update the Claude CLI configuration
claude mcp add audius audius-mcp-atris

Or configure Claude Desktop using the globally installed executable path:

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

Available Tools

This server exposes the following functional categories for interaction:

Discovery Tools

• Search: Locate content, users, or lists using various filtering parameters.
• Advanced Search: Perform targeted searches incorporating genre, mood, tempo, and other attributes.
• Trending Discovery: Retrieve currently popular or emerging musical submissions.
• Similar Artists: Identify creators whose output aligns stylistically with preferred artists.

Track Tools

• Get Track Info: Retrieve comprehensive metadata associated with a specific identifier.
• Search Tracks: Execute searches across the track catalog using specified criteria.
• Trending Tracks: Discover the currently most favored musical pieces on the network.
• Track Comments: Read existing discussions or contribute new remarks to a piece.
• Track Analytics: Access metrics covering plays, popularity trends, and audience demographics.

User Tools

• User Profiles: Obtain detailed attribute sets defining a specific platform member.
• User Tracks: List all compositions uploaded by an identified user.
• Follow User: Establish a connection or subscription to another user's activity.
• User Analytics: Monitor play statistics, list of supporters, and contribution visibility.

Content Creation

• Upload Track: Submit newly produced audio files to the Audius ecosystem.
• Update Track: Modify the descriptive metadata of an existing composition.
• Create Playlist: Assemble and name a new sequential collection of tracks.
• Playlist Management: Perform actions like adding, deleting, or reordering items within a collection.

Social Interaction

• Follow Artists: Form official connections with content producers.
• Favorite Tracks: Mark preferred tracks to signify appreciation and save them.
• Comments: Publish user feedback onto specific musical submissions.
• Reposts: View records of which members have shared specific content.
• Messaging: Transmit and receive private communications between platform members.

Monetization

• Premium Content: Check availability and initiate purchases for exclusive material.
• NFT-Gated Content: Verify access rights secured via Non-Fungible Tokens.
• Purchase Tracks: Acquire ownership rights for premium content using various payment mechanisms.
• Send Tips: Offer direct financial gratuities to performing artists.
• Track Transactions: Review the history of tips issued and sales statistics.

Blockchain & Wallet

• Wallet Management: Oversee associated Ethereum and Solana cryptocurrency wallets.
• Token Balances: Inquire about current holdings of platform-related cryptocurrencies.
• Transactions: Review historical financial movements and authorize new transfers.
• Rewards: Access information concerning platform incentives and active participation challenges.

Resources

Access Audius data structures directly using these standardized identifier patterns:

• audius://track/{id}: Direct link to track data based on its unique identifier.
• audius://user/{id}: Direct link to a user's profile based on their unique identifier.
• audius://playlist/{id}: Direct link to a playlist's details based on its unique identifier.
• audius://album/{id}: Direct link to an album's details based on its unique identifier.

Prompts

The server facilitates guided operational sequences for frequent requirements:

• Music Discovery: Offers tailored suggestions based on stated preferences.
• Track Analysis: Aids in deconstructing track attributes and generating insights.
• Artist Profiles: Constructs comprehensive summaries of creator activities.
• Music Creation: Provides support during the process of track development and publication.
• Playlist Curation: Assists in building and subsequently promoting curated collections.
• Messaging: Guides the process of user-to-user communication.
• Analytics: Generates reports summarizing performance statistics.
• Blockchain: Offers assistance with cryptocurrency operations and ledger access.
• Monetization: Guides the setup procedures for premium content sales.
• Notifications: Helps organize and manage system alerts received from the platform.

Related Topics

• Digital Media Distribution
• Decentralized Autonomous Organizations (DAO)
• Digital Rights Management (DRM)
• Algorithmic Recommendation Systems
• Cryptocurrency Wallets
• Intellectual Property in the Digital Age

Extra Details

The structure of this tool set mirrors the complexities inherent in modern digital distribution, where creators must navigate copyright, moderation, and monetization simultaneously. For instance, platform moderation policies and the repercussions of violating community guidelines are important considerations for anyone engaged in content creation.

Setup

NPM Installation (Recommended Procedure)

Install the package directly using the npm registry:

npm install audius-mcp-atris

Alternatively, use yarn for package management:

yarn add audius-mcp-atris

Manual Installation Steps

1. Obtain a local copy of the repository source code:

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

1. Install all necessary project dependencies:

npm install

1. Compile the underlying TypeScript source code into executable JavaScript:

npm run build

Configuration

Establish a .env file inside the main project directory, referencing the structure provided in the .env.example file:

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

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

Usage

Launching the Server Process

Initiate the server execution:

npm start

For an environment that rebuilds automatically during coding changes:

npm run dev

Connecting to Claude

To use this server alongside Claude:

1. Obtain and install Claude for Desktop or the Claude CLI

NPX Installation (Most Convenient Option)

The simplest method for utilizing this MCP server involves npx, allowing execution without a persistent global installation:

For Claude CLI Users:

claude mcp add audius npx audius-mcp-atris

For Claude Desktop Users:

Modify the configuration file named claude_mcp_config.json. The precise location depends on your 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

Append this structure to the existing configuration data:

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

For Other LLM Applications

If your application supports the Model Context Protocol standard, integrate this configuration into its specific configuration 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 a global installation is preferred for local execution:

# Install the package globally across the system
npm install -g audius-mcp-atris

# Then, update the Claude CLI configuration
claude mcp add audius audius-mcp-atris

Or configure Claude Desktop using the globally installed executable path:

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

Example Workflows

Music Discovery

// Search for electronic tracks
search-tracks --query "electronic" --limit 5

// Get trending tracks in a genre
get-trending-tracks --genre "House" --limit 10

// Find artists similar to a specific one
similar-artists --userId "123456"

Content Creation

// Upload a new track
upload-track --userId "123" --title "Summer Vibes" --genre "Electronic" --audioFileUrl "https://example.com/track.mp3"

// Create a playlist
create-playlist --userId "123" --playlistName "Chillout Mix" --description "Perfect for relaxing"

// Add tracks to a playlist
add-tracks-to-playlist --userId "123" --playlistId "456" --trackIds ["789", "101", "102"]

Social Features

// Follow a user
follow-user --userId "123" --followeeId "456"

// Favorite a track
favorite-track --userId "123" --trackId "789"

// Add a comment
add-track-comment --trackId "789" --userId "123" --comment "Great track!"

Monetization

// Check track access gates
track-access-gates --trackId "789"

// View purchase options
purchase-options --contentId "789" --contentType "track"

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

Testing

For iterative local validation:

1. Install the MCP Inspector utility globally:

npm install -g @modelcontextprotocol/inspector

1. Execute the inspector, pointing it toward your compiled server entry point:

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

Development

Project Structure

├── src/
│   ├── index.ts          # Entry point
│   ├── server.ts         # MCP server setup
│   ├── config.ts         # Configuration handling
│   ├── sdk-client.ts     # Audius SDK client wrapper
│   ├── tools/            # MCP tool implementations
│   │   ├── tracks.ts               # Track-related tools
│   │   ├── users.ts                # User-related tools
│   │   ├── playlists.ts            # Playlist-related tools
│   │   ├── search.ts               # Search-related tools
│   │   ├── social.ts               # Social interaction tools
│   │   ├── comments.ts             # Comment management tools
│   │   ├── track-management.ts     # Track upload and management
│   │   ├── playlist-management.ts  # Playlist creation and management
│   │   ├── messaging.ts            # Direct messaging tools
│   │   ├── analytics.ts            # Analytics and metrics tools
│   │   ├── blockchain.ts           # Cryptocurrency and blockchain tools
│   │   ├── monetization.ts         # Premium content and payment tools
│   │   └── notifications.ts        # Platform notification tools
│   ├── resources/        # MCP resource implementations
│   │   ├── tracks.ts     # Track-related resources
│   │   ├── users.ts      # User-related resources
│   │   └── playlists.ts  # Playlist-related resources
│   └── prompts/          # MCP prompt implementations
│       ├── music-search.ts      # Music discovery prompts
│       ├── track-info.ts        # Track analysis prompts
│       ├── artist-profile.ts    # Artist profile prompts
│       ├── music-creation.ts    # Music creation prompts
│       ├── playlist-creation.ts # Playlist creation prompts
│       ├── messaging.ts         # Messaging prompts
│       ├── analytics.ts         # Analytics prompts
│       ├── blockchain.ts        # Blockchain prompts
│       ├── monetization.ts      # Monetization prompts
│       └── notifications.ts        # Notification prompts

Conclusion

This interface provides a robust bridge between large language models and the Audius decentralized music network. It standardizes complex API interactions into manageable tools, directly supporting both the consumption and the production sides of digital music creation. By abstracting the technical requirements, users can focus on artistic and curation tasks within this evolving digital media landscape.