TraktGPT MCP 1.2 + GPTs
Online & Multi-User Ready
OpenAPI JSON

Trakt.tv AI & MCP Connector

High-performance Streamable HTTP MCP server & OAuth 2.1 bridge. Connects ChatGPT, Claude Desktop, Cursor, and Custom GPTs to Trakt.tv with strict user isolation, watch progress tracking, TV shows, and streaming availability.

Streamable MCP Endpoint
/mcp

Streamable HTTP MCP protocol URL

Protected Resource
/.well-known/oauth-protected-resource

RFC 9728 discovery metadata

Auth Server Metadata
/.well-known/oauth-authorization-server

RFC 8414 discovery metadata

OpenAPI Actions Spec
/openapi.json

Custom GPT OpenAPI 3.1.0 schema (50 endpoints)

Model Context Protocol (MCP) Setup

Connect this server as a streamable MCP tool provider in ChatGPT, Claude Desktop, Cursor, or autonomous AI agents.

40 Tools 4 Prompts 4 Resources

ChatGPT MCP Setup

In ChatGPT Settings → Connected Apps → Add Server:

https://traktgpt.pcro.eu/mcp
  • Automatic OAuth 2.1 discovery via RFC 9728 & RFC 8414.
  • Interactive Trakt device authentication on first connection.
  • Encrypted user session stored with AES-256-GCM.

Claude Desktop & Cursor

Add to your claude_desktop_config.json or Cursor MCP config: 

{
  "mcpServers": {
    "traktgpt": {
      "type": "streamable-http",
      "url": "https://traktgpt.pcro.eu/mcp"
    }
  }
}

MCP Prompts & Resources

Prompt: movie_night_recommendation

Recommends unseen films based on mood & watchlist.

Prompt: binge_planner

Plans weekend episode binge based on watch progress.

Resource: trakt://user/up-next

Live snapshot of next unwatched episodes.

40 Exposed MCP Tools

get_trakt_profile
get_movie_history
get_show_history
get_movie_ratings
get_show_ratings
get_watchlist
get_lists
get_list_items
get_show_progress
get_up_next
get_calendar_schedule
get_watch_now
search_movies
search_shows
search_people
get_person_details
get_movie_details
get_show_details
get_show_seasons
get_episode_details
get_trending_shows
get_popular_shows
get_recommendation_context
get_playback
get_comments
discover_titles
export_user_library
add_to_history
remove_from_history
rate_item
remove_rating
add_to_watchlist
remove_from_watchlist
create_list
add_to_list
remove_from_list
scrobble_start
scrobble_pause
scrobble_stop
post_comment

Custom GPT Actions Setup Guide

Configure your personal Trakt movie & show AI assistant in Custom GPT Actions.

Step 1 Trakt Apps

Create Trakt API App

Ensure your Trakt application has the redirect URIs configured:

  • Redirect URIs:
    https://chat.openai.com/aip/g-trakt/oauth/callback
    https://traktgpt.pcro.eu/oauth/trakt/callback
  • Permissions: Check /public
Step 2 GPT Editor

Create Custom GPT

Go to ChatGPT → Create a GPT → Configure → Create new action:

  • Click Import from URL
  • Paste: https://traktgpt.pcro.eu/openapi.json
  • Set Privacy Policy: https://traktgpt.pcro.eu/privacy
Step 3 Action Auth

Set OAuth in ChatGPT

Under Action Authentication, select OAuth:

  • Client ID: Your Trakt Client ID
  • Client Secret: (Leave blank / PKCE)
  • Authorization URL: https://traktgpt.pcro.eu/oauth/authorize
  • Token URL: https://traktgpt.pcro.eu/oauth/token
Intermediary Trakt authentication active!

Live API Playground & Tester

Test Trakt endpoints directly in your browser.

Response

Click "Send Request" to preview movie & TV show poster cards...