# SmugMug — how to use (mcp.ai)

Connect your SmugMug account and use 25 tools for images and design straight from your AI agent. Connect with your own API key. SmugMug is a platform for photographers to showcase, share, and sell their photos and videos.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_smugmug?ms=1787291340000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `smugmug_get_album`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/smugmug`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/smugmug/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/smugmug/get/album` — Retrieves detailed information about a SmugMug album using its album key. Returns album settings, metadata, image count, and links to related resources like images and user info. Use this to get compr
  - body: { album_key: string }
- `POST https://api.mcp.ai/api/smugmug/get/album/highlight/image` — Retrieves the highlight/cover image for a SmugMug album. Returns detailed information about the album's cover image including dimensions, URLs, and metadata. Use this when you need to get the featured
  - body: { album_key: string }
- `POST https://api.mcp.ai/api/smugmug/get/album/image` — Get an image within a specific album context as an AlbumImage relationship object. Returns detailed information about the image including metadata, dimensions, URLs, and relationships. Use this when y
  - body: { album_key: string, image_key: string }
- `POST https://api.mcp.ai/api/smugmug/get/album/images` — Tool to retrieve all images in a SmugMug album as AlbumImage relationship objects. Use this action when you need to list or access images within a specific album. An AlbumImage represents the relation
  - body: { count?: integer, start?: integer, album_key: string }
- `POST https://api.mcp.ai/api/smugmug/get/folder/albums` — Tool to retrieve albums from a specific folder in a SmugMug user's account by nickname and folder path. Use when you need to list albums in a folder using the user's nickname and folder path rather th
  - body: { path?: string, FolderID?: string, nickname: string }
- `POST https://api.mcp.ai/api/smugmug/get/folder/by/user/path` — Tool to retrieve folder details by user nickname and folder path. Use when you need to access a specific folder within a user's SmugMug account using the hierarchical path structure. Note: For New Smu
  - body: { nickname: string, folder_path: string }
- `POST https://api.mcp.ai/api/smugmug/get/folder/details` — Retrieves details of a specific folder in SmugMug using its Node ID. Returns folder metadata including name, description, URL path, creation and modification dates, node ID, and optionally the URI of 
  - body: { node_id: string }
- `POST https://api.mcp.ai/api/smugmug/get/folder/subfolders` — Retrieves all subfolders within a specified folder in a SmugMug user's account. Use this action to navigate the folder hierarchy by fetching direct child folders of a given parent folder. Specify the 
  - body: { path?: string, nickname: string, folder_id?: string }
- `POST https://api.mcp.ai/api/smugmug/get/image` — Tool to retrieve details for a specific image (photo or video) by its image key. Returns comprehensive image metadata including dimensions, upload dates, geolocation, and links to related resources li
  - body: { image_key: string }
- `POST https://api.mcp.ai/api/smugmug/get/image/metadata` — Tool to retrieve additional metadata from an image file including EXIF data, camera settings, GPS location, and other embedded information. Use when you need detailed technical information about an im
  - body: { image_key: string }
- `POST https://api.mcp.ai/api/smugmug/get/image/size/details` — Retrieve raw media URLs and dimensions for all available sizes of an image. Returns detailed information including direct download URLs, dimensions, and file sizes for each variant. Use this when you 
  - body: { image_key: string }
- `POST https://api.mcp.ai/api/smugmug/get/image/sizes` — Retrieves available image sizes and URLs for a SmugMug image by its unique image key. Use this to get download URLs for different resolutions (tiny, thumb, small, medium, large, xlarge, original, etc.
  - body: { image_key: string }
- `POST https://api.mcp.ai/api/smugmug/get/node/highlight/image` — Tool to get the highlight/cover image for a node (folder, album, or page). Use when you need to retrieve the representative image set for a SmugMug node.
  - body: { node_id: string }
- `POST https://api.mcp.ai/api/smugmug/get/node/parent` — Tool to retrieve the parent node of a specified SmugMug node. Use when navigating up the folder hierarchy or determining a node's location within the organizational structure.
  - body: { node_id: string }
- `POST https://api.mcp.ai/api/smugmug/get/node/parents` — Tool to retrieve a node and all its ancestor nodes (breadcrumb trail). Use when you need to understand the full hierarchy path from a node to the root.
  - body: { node_id: string }
- `POST https://api.mcp.ai/api/smugmug/get/user` — Tool to get a SmugMug user account by their nickname. Returns user details including display name, view pass hint, and links to related resources like albums, profile, and images. Use when you need to
  - body: { nickname: string }
- `POST https://api.mcp.ai/api/smugmug/get/user/bio/image` — Tool to retrieve the bio image for a SmugMug user by their nickname (username). Use when you need to get information about a user's bio/profile image including image metadata, dimensions, URLs, and re
  - body: { nickname: string }
- `POST https://api.mcp.ai/api/smugmug/get/user/featured/albums` — Retrieves the featured albums for a SmugMug user by their nickname. Use this when you need to see which albums a user has highlighted as featured content on their profile.
  - body: { nickname: string }
- `POST https://api.mcp.ai/api/smugmug/get/user/features` — Tool to retrieve a list of features available to a SmugMug user based on their subscription plan. Use when you need to check what capabilities or features a specific user has access to on SmugMug.
  - body: { nickname: string }
- `POST https://api.mcp.ai/api/smugmug/get/user/profile` — Retrieves the public profile information for a SmugMug user by their nickname (username). Returns profile details including name, bio, contact email, and social media links. Use this to get informatio
  - body: { nick_name: string }
- `POST https://api.mcp.ai/api/smugmug/get/user/root/node` — Tool to retrieve the root node of a user's folder tree on SmugMug. Use when you need to navigate a user's gallery structure or find the starting point of their folder hierarchy.
  - body: { nickname: string }
- `POST https://api.mcp.ai/api/smugmug/list/child/nodes` — Lists all child nodes (folders and albums) under a specified parent node in SmugMug. Use this action to navigate SmugMug's folder/album hierarchy. Start from a user's root node (obtained from user pro
  - body: { count?: integer, start?: integer, node_id: string }
- `POST https://api.mcp.ai/api/smugmug/search/user/content` — Search for images across a user's SmugMug content. This tool searches through a user's images by querying titles, captions, keywords, and filenames. Returns a list of matching images with details like
  - body: { q: string, Order?: string, count?: integer, start?: integer, nickname: string }
- `POST https://api.mcp.ai/api/smugmug/unlock/album` — Tool to unlock a password-protected SmugMug album. Use when you need to access content in a locked album. Only available for albums that are currently password-protected.
  - body: { Password: string, album_key: string }
- `POST https://api.mcp.ai/api/smugmug/unlock/user` — Tool to unlock a user's password-protected SmugMug site. Use when you need to access a locked user's site content. This action is only available if the user's site is currently locked with a password.
  - body: { nickname: string, password: string }

## Example prompts
- "What can I do in SmugMug?"
- "Show me a summary of my SmugMug account"

## More
- Page: https://mcp.ai/smugmug
- Agent spec (llms.txt): https://mcp.ai/smugmug/llms.txt
- Postman collection: https://mcp.ai/smugmug/postman.json