Media
MP3 Compress
Compress an MP3 by re-encoding at a lower bitrate
file· File result
Quick start
Call this tool from your code in three languages.
cURL
# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/mp3-compress' \
-F 'file=@/path/to/audioFile.ext'
# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/en/api/tools/mp3-compress' \
-F 'audioFile=/path/to/file.ext' \
-F 'bitrate=128k' \
-F 'sampleRate=auto' \
-F 'channels=auto' \
-F 'keepMetadata=true'
API reference
Send a POST request with your inputs as JSON. File parameters require a separate upload first.
Endpoint
HTTP
POST https://api.elysiatools.com/en/api/tools/mp3-compress
Parameters
| Name | Type | Required | Description |
|---|
| audioFile | fileupload required | Yes | — |
| bitrate | select | No | — |
| sampleRate | select | No | — |
| channels | select | No | — |
| keepMetadata | checkbox | No | — |
MCP integration
Add this tool to your Model Context Protocol server so AI agents can list and call it.
Server configuration
Add this block to your MCP client configuration:
mcp.json
{
"mcpServers": {
"elysiatools-mp3-compress": {
"name": "mp3-compress",
"description": "Compress an MP3 by re-encoding at a lower bitrate",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=mp3-compress",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}
List available tools
After connecting to the SSE endpoint, list the exposed tools:
tools/list
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}
Call this tool
Invoke the tool by its id, passing arguments built from its parameters:
tools/call
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "mp3-compress",
"arguments": {
"audioFile": "https://example.com/file.ext",
"bitrate": "128k",
"sampleRate": "auto",
"channels": "auto",
"keepMetadata": true
}
}
}
Chain multiple tools in one session with a comma-separated toolId list, e.g. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max 20). File-type parameters must be uploaded first via POST /upload/mp3-compress, then the returned filePath is passed to the corresponding file field.
Response format
File result
JSON
{
"filePath": "/public/processing/randomid.ext",
"fileName": "output.ext",
"contentType": "application/octet-stream",
"size": 1024,
"metadata": {
"key": "value"
},
"error": "Error message (optional)",
"message": "Notification message (optional)"
}
File parameters accept a public file URL only (https://…). Local paths, data: URIs, and Base64 strings are not supported.
MP3 Compress — API & MCP | Elysia Tools