Skip to main content
Glama
SavageCore

tracearr-mcp

by SavageCore
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

tracearr-mcp

MCP server exposing Tracearr's Public API v2 (REST, read-only) as tools, so an LLM can query your Plex, Jellyfin, and Emby monitoring data: watch history, active streams, media, users, libraries, and recently added items.

Built with FastMCP, ported from the dashy-mcp template.

Enabling the API on your Tracearr server

The Public API is read-only and requires a bearer API key. Generate one in Tracearr Settings > General — the key looks like trr_pub_<token>. See the API reference for details.

Related MCP server: moviefinder-mcp

Install

Download a wheel from the latest release and install it as a uv tool (no repo checkout needed):

uv tool install tracearr_mcp-*.whl

This puts a tracearr-mcp command on your PATH. Register it with Claude Code:

claude mcp add tracearr \
  --env TRACEARR_URL=https://your-tracearr-host \
  --env TRACEARR_API_KEY=<key> \
  -- tracearr-mcp

From source

uv sync
cp .env.example .env   # fill in TRACEARR_URL and TRACEARR_API_KEY
claude mcp add tracearr \
  --env TRACEARR_URL=https://your-tracearr-host \
  --env TRACEARR_API_KEY=<key> \
  -- uv run --directory /path/to/tracearr-mcp tracearr-mcp

Config

Env var

Required

Default

TRACEARR_URL

yes

-

TRACEARR_API_KEY

yes*

none (no auth header sent if unset)

* Every API endpoint requires auth; practically you must set it, but the server still starts without one so errors surface from the API rather than at startup.

Tools

One tool per Tracearr Public API v2 endpoint. All are read-only.

Tool

Endpoint

tracearr_get_history

GET /api/v2/public/history

tracearr_get_streams

GET /api/v2/public/streams

tracearr_get_media

GET /api/v2/public/media/{ref}

tracearr_get_media_children

GET /api/v2/public/media/{ref}/children

tracearr_get_media_stats

GET /api/v2/public/media/{ref}/stats

tracearr_get_media_watchers

GET /api/v2/public/media/{ref}/watchers

tracearr_get_media_history

GET /api/v2/public/media/{ref}/history

tracearr_list_users

GET /api/v2/public/users

tracearr_get_user

GET /api/v2/public/users/{id}

tracearr_get_user_stats

GET /api/v2/public/users/{id}/stats

tracearr_get_user_history

GET /api/v2/public/users/{id}/history

tracearr_list_recently_added

GET /api/v2/public/recently-added

tracearr_list_libraries

GET /api/v2/public/libraries

ref accepts a canonical media uuid or a type-qualified provider ref such as movie:tmdb:584 or show:tvdb:81189. Cursor-paginated tools take cursor and page_size; read meta.nextCursor from the response and pass it back as cursor to fetch the next page. Optional params are omitted when unset so the API's defaults apply.

Development

make help  # list all commands

Command

Does

make sync

uv sync

make test

Offline tests - one per endpoint, mocked HTTP

make test-integration

Tests against the live instance (needs TRACEARR_URL/TRACEARR_API_KEY)

make build

Build wheel + sdist into dist/

make bump-patch / bump-minor / bump-major

Bump the version in pyproject.toml + uv.lock

make clean

Remove build artifacts

The release workflow (.github/workflows/release.yml) builds and publishes to Releases whenever a v* tag is pushed - so the usual flow is make bump-patch, commit, then tag and push.

The integration suite is read-only (the Tracearr public API has no write surface), so it never modifies your instance.

This server cannot be installed

A
license - permissive license
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • servarr-mcp

    CarlDog
    A
    license
    A
    quality
    A
    maintenance
    An MCP server for the Servarr stack — Sonarr, Radarr, Lidarr, Readarr, and Prowlarr — packaged as a Docker container. Lets an MCP client (Claude Desktop, etc.) browse and search whichever \*arr apps you're running.
    29
    MIT

  • moviefinder-mcp

    AmeliaMiddleton
    F
    license
    A
    quality
    D
    maintenance
    An MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.
    8

  • nas-mcp-server

    matthieurosset
    A
    license
    A
    quality
    D
    maintenance
    MCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.
    12
    MIT

  • Arr-MCP

    LtMarx
    F
    license
    A
    quality
    A
    maintenance
    MCP server to manage your *ARR media stack (Radarr, Sonarr, Lidarr, Readarr, Prowlarr) for searching, adding, and managing movies, TV shows, music, books, and indexers.
    1

View all related MCP servers

Related MCP Connectors

  • Trakt

    Trakt MCP — TV/movie metadata + watch tracking signals

  • classquill-mcp

    Read-only MCP server for ClassQuill, a tutoring-business-management platform.

  • Mastodon

    Mastodon MCP — public Mastodon data via mastodon.social (no auth required)

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/SavageCore/tracearr-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server