Let your AI assistant use MediaHub

1. Create a token

In the MediaHub admin page open Settings → Account → App passwords (Subsonic & Music) and create one. MCP accepts that password — one minted for subsonic, api or mcp is treated the same way. The token is shown once, so copy it there and then.

MCP accepts a token in the Authorization header, or — from a browser already signed in as an admin — the session cookie. It is never accepted in the address: a token in a query string would land in the server's access log and in browser history.

2. Claude Desktop

{
  "mcpServers": {
    "qelvue-mediahub": {
      "url": "http://your-server:8096/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

3. Cursor

{
  "mcpServers": {
    "qelvue-mediahub": {
      "url": "http://your-server:8096/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Available tools

• search_media — Find films, series and channels in your library.
• get_media_details — Full details for one title.
• get_continue_watching — What a profile was last watching.
• get_recommendations — Suggestions from a profile's history.
• get_live_tv_guide — What's on now and next.
• get_profile_info — Profile settings and limits.

Hosted Pod plans are planned, not available yet; when they ship, a Pod would come with a dedicated MCP address to use in place of your-server:8096.