Audius MCP Server

@glassbead/mcp-audius

Configuration

Configure the MCP server in your client's settings:

Claude Desktop

Add to claude_desktop_config.json:

{ "mcpServers": { "mcp-audius": { "command": "npx", "args": ["@glassbead/mcp-audius"], "env": { "AUDIUS_API_KEY": "your-api-key" } } } }

VSCode

Add to your MCP settings file:

{ "mcpServers": { "mcp-audius": { "command": "npx", "args": ["@glassbead/mcp-audius"], "env": { "AUDIUS_API_KEY": "your-api-key" } } } }

Environment Variables

Copy .env.example to .env.local and configure:

cp .env.example .env.local

Required:

  • AUDIUS_API_KEY: Your Audius API key (obtain from Audius)

Features

Track Operations

  • Search tracks with filtering and sorting
  • Get track details and metadata
  • Stream tracks with efficient caching
  • Manage track favorites
  • Access track comments
  • Get trending tracks with pagination

User Operations

  • Get user profiles and details
  • Search for users
  • Follow/unfollow functionality
  • View user's tracks, favorites, and reposts
  • Get user followers and following
  • Access trending users

Playlist & Album Management

  • Access playlist details and tracks
  • View album information
  • Get trending playlists
  • Manage playlist favorites

Performance Features

  • Efficient LRU caching system for stream URLs
  • Automatic cache cleanup and monitoring
  • Connection tracking and rate limiting
  • Graceful shutdown support

Performance Considerations

Batch Request Limits

⚠️ Important: Requesting more than 10 tracks or playlists at once may result in extended wait times. For optimal performance:

  • Limit batch requests to 10 or fewer items
  • Utilize pagination for larger datasets
  • Consider using the caching system for frequently accessed content

Caching Behavior

The server implements an LRU (Least Recently Used) cache for stream URLs with:

  • Automatic TTL-based expiration
  • Memory usage optimization
  • Built-in monitoring and statistics

Streaming Server

  • Default port: 3333 (configurable)
  • Rate limiting: 60 requests/minute
  • Range request support for seeking
  • Proper CORS configuration

Development

Building from Source

git clone https://github.com/glassBead-tc/audius-mcp.git cd audius-mcp npm install npm run build

Running Tests

npm test

Documentation

Version Information

Current version: 1.3.3

Notable changes in recent versions:

  • Added performance warning prompts
  • Improved streaming reliability
  • Enhanced caching system
  • Removed blockchain/financial features to focus on core music experience

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

Enables interaction with the Audius music platform API, supporting user, track, and playlist operations through the Model Context Protocol.

  1. Configuration
    1. Claude Desktop
      1. VSCode
        1. Environment Variables
        2. Features
          1. Track Operations
            1. User Operations
              1. Playlist & Album Management
                1. Performance Features
                2. Performance Considerations
                  1. Batch Request Limits
                    1. Caching Behavior
                      1. Streaming Server
                      2. Development
                        1. Building from Source
                          1. Running Tests
                          2. Documentation
                            1. Version Information
                              1. License