Iconik MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_PORT | No | Port for HTTP transport (default: '8000') | |
| ICONIK_APP_ID | Yes | App ID for Iconik API authentication | |
| MCP_TRANSPORT | No | Transport mode: 'stdio' or 'http' (default: 'stdio') | |
| ICONIK_API_URL | No | Optional custom API URL (default: https://app.iconik.io/API/) | |
| MCP_ACCESS_LEVEL | No | Access level for tools: 'read', 'readwrite', or 'full' (default: 'read') | |
| ICONIK_AUTH_TOKEN | Yes | Auth token for Iconik API authentication |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_assetsB | List all assets with pagination |
| get_assetB | Get detailed information about a specific asset by ID |
| list_asset_versionsB | List all versions of an asset |
| get_asset_versionB | Get details of a specific asset version |
| get_asset_historyA | Get the history/audit log for an asset |
| list_asset_segmentsB | List all segments (markers, chapters, transcriptions, etc.) for an asset |
| get_asset_segmentB | Get a specific segment by ID |
| export_segments_srtB | Export asset segments as SRT subtitle format |
| export_segments_vttB | Export asset segments as WebVTT subtitle format |
| list_asset_proxiesB | List all proxy files for an asset |
| get_asset_proxyB | Get details of a specific proxy |
| get_proxy_download_urlB | Get a temporary download URL for a proxy file |
| get_proxy_public_urlA | Get a public streaming URL for a proxy (if available) |
| list_asset_keyframesA | List all keyframes/thumbnails for an asset |
| get_asset_keyframeC | Get details of a specific keyframe |
| get_keyframe_public_urlB | Get a public URL for a keyframe image |
| list_asset_formatsA | List all formats (ORIGINAL, PROXY, etc.) for an asset |
| get_asset_formatC | Get details of a specific format |
| list_asset_file_setsB | List all file sets for an asset |
| get_asset_file_setC | Get details of a specific file set |
| list_file_set_filesA | List all file records in a specific file set |
| get_asset_file_set_detailsC | Get a combined view of all file sets for an asset with storage names and file records |
| list_asset_filesB | List all files associated with an asset |
| get_asset_fileC | Get details of a specific file |
| get_file_download_urlA | Get a temporary download URL for an original file |
| get_file_mediainfoB | Get mediainfo/technical metadata for a file |
| list_asset_subtitlesC | List all subtitle tracks for an asset |
| get_subtitle_webvttC | Get subtitle content in WebVTT format |
| list_relation_typesA | List all available asset relation types |
| list_asset_relationsB | List all relations for an asset |
| get_transcription_propertiesC | Get transcription properties for an asset version |
| get_transcription_subtitlesC | Get transcription as subtitles |
| search_assetsB | Search for assets in Iconik using a query string |
| search_facetedC | Perform a faceted search to get aggregations/counts |
| search_by_metadataA | Search assets by specific metadata field values |
| search_by_date_rangeC | Search assets created within a date range |
| list_collectionsC | List all collections with pagination |
| get_collectionC | Get detailed information about a specific collection |
| get_collection_contentsA | Get the contents (assets and sub-collections) of a collection |
| get_collection_ancestorsA | Get all ancestor collections (parent hierarchy) |
| get_collection_subcollectionsA | Get direct child sub-collections |
| get_collection_full_pathC | Get the full path of a collection (breadcrumb) |
| get_collection_sizeA | Get the total size of all files in a collection |
| check_collection_archive_healthA | Scan a collection and report archive health: group assets by archive_status, flag ARCHIVING stuck >24h, list FAILED_TO_ARCHIVE assets. |
| get_asset_metadataB | Get all metadata views and values for an asset |
| get_asset_metadata_viewC | Get metadata for a specific view |
| get_collection_metadataB | Get all metadata views and values for a collection |
| list_metadata_viewsB | List all available metadata views |
| get_metadata_viewA | Get details of a specific metadata view including its fields |
| list_metadata_fieldsB | List all available metadata fields |
| get_metadata_fieldC | Get details of a specific metadata field |
| list_storagesB | List all configured storage locations |
| get_storageA | Get details of a specific storage location |
| get_storage_for_purposeC | Find the default storage for a specific purpose |
| list_storage_filesC | List files in a storage location |
| list_transcodersA | List all configured transcoders |
| get_transcoderA | Get details of a specific transcoder |
| list_storage_transfers_fromA | List pending transfers from a storage |
| list_storage_transfers_toA | List pending transfers to a storage |
| list_export_locationsA | List all configured export locations |
| get_export_locationB | Get details of a specific export location |
| list_deleted_file_setsB | List file sets in the delete queue |
| list_deleted_formatsA | List formats in the delete queue |
| list_analysis_profilesA | List all analysis profiles for media processing |
| get_analysis_profileA | Get details of a specific analysis profile |
| list_jobsC | List all jobs with pagination |
| list_child_jobsB | List child jobs of a parent job |
| get_jobC | Get details of a specific job |
| list_job_stepsA | List all steps/tasks for a job |
| list_usersC | List all users in the system |
| get_userC | Get details of a specific user |
| get_current_userA | Get the currently authenticated user |
| list_groupsB | List all groups in the system |
| get_groupC | Get details of a specific group |
| list_group_membersB | List all members of a group |
| list_user_groupsA | List all groups a user belongs to |
| list_sharesC | List all shares |
| get_asset_sharesA | Get all shares for a specific asset |
| get_collection_sharesB | Get all shares for a specific collection |
| get_shareC | Get details of a specific share |
| get_share_urlB | Get the public URL for a share |
| list_share_usersA | List users who have access to a share |
| get_asset_approvalB | Get approval status for an asset |
| get_segments_textB | Get all segment text content as plain text |
| search_segmentsB | Search for segments across all assets |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 85 tools
Most tools map cleanly to distinct resources and actions, with a consistent list/get/search hierarchy. A few pairs like get_asset_file_set_details vs get_asset_file_set and get_subtitle_webvtt vs get_transcription_subtitles have somewhat overlapping boundaries, but the descriptions generally make the intended target clear.
The set overwhelmingly follows a snake_case verb_noun pattern: list_*, get_*, search_*. Minor deviations such as check_collection_archive_health, search_faceted, and get_storage_for_purpose break the pattern slightly but do not make the naming chaotic.
With 85 tools, the surface is extremely large and exceeds even the 50+ threshold for an extreme mismatch. Many serial getters for closely related sub-resources like proxies, keyframes, formats, and file sets could be consolidated, making the tool set overwhelming for agents.
Read coverage is broad: assets, collections, metadata, storage, jobs, users, groups, and shares are all represented. However, the surface is almost entirely read-only; there are no create, update, delete, upload, ingest, metadata-editing, share-management, or job-control tools, so core media management workflows cannot be completed.