# Casting42 MCP > Casting42 MCP manages your entire talent database and casting workflow. Connect it to any AI agent, and you can pull up profiles, media assets, project details, and custom attributes instantly through natural conversation. It lets you find exactly who you need for a role without ever opening the dashboard. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** talent-database, casting, talent-management, profile-management, recruitment, media-assets ## Description You connect this MCP to your preferred AI client—Claude, Cursor, or any compatible agent. Once connected, you get full control of your talent database right from your chat window. You don't have to learn a new interface just to find an actor’s headshot; you simply ask for it. This system lets you pull complex data through conversation. Need to know which categories or custom fields are tracked? Ask the agent, and it lists them out. Want to check on active jobs? The agent pulls up project status in real time. It's about making talent discovery fast and specific. Because Vinkius hosts this MCP, your AI client gets instant access to all of Casting42’s tools, letting you manage everything from finding a niche model to tracking down every single media file associated with them. ## Tools ### get_talent_details Retrieves detailed information for one specific person in the database. ### list_talent_categories Retrieves the configured group types used to classify talent (e.g., Actors, Models). ### list_custom_attributes Displays a list of unique data fields defined in your talent database setup. ### list_talent_media Lists all media assets, such as videos or headshots, for a given talent ID. ### list_casting_projects Lists all current and active casting projects you manage. ### list_talent_tags Shows the available tags used to organize and filter your talent pool. ### list_talents Provides a broad list of every individual profile in the database. ### search_talents Searches for specific talent profiles using names or multiple criteria simultaneously. ## Prompt Examples **Prompt:** ``` Search for talents named 'John' in my Casting42 database. ``` **Response:** ``` Searching for 'John'... I found 3 profiles: John Smith (Actors), John Doe (Models), and John Wayne (Stunt). Which one would you like to see details for? ``` **Prompt:** ``` Show me the media files for talent ID 12345. ``` **Response:** ``` Retrieving media for talent 12345... I found 2 headshots, 1 showreel video, and 3 self-tapes. You can access them via these links: [Links provided]. ``` **Prompt:** ``` What are the active casting projects right now? ``` **Response:** ``` Checking active projects... You have 2 active projects: 'Summer Commercial 2024' and 'Feature Film - Project X'. Both are currently in the 'Selection' phase. ``` ## Capabilities ### Find talent by criteria Search the entire database for actors or models based on names, attributes, and categories. ### Review full profiles Pull up all known details about a single person, including custom organizational tags and complete history. ### Access media assets Retrieve links to headshots, videos, or self-tapes linked to specific talent profiles. ### Check project status List and monitor the current status of active casting projects. ### Understand data structure View all available custom fields, categories, or tags used within your specific database setup. ## Use Cases ### A project needs a specific look. The Casting Director can't find enough people who fit the 'vintage 1920s' description. They ask their agent to run `list_talent_tags` to see available tags, then follow up with a search using those precise tags and the talent details tool to narrow down candidates. ### The production team needs quick media verification. A coordinator needs to confirm if a specific actor has updated their showreel. They use `get_talent_details` first, then follow up with `list_talent_media` to get all the latest video links in one go. ### The agent needs to report on multiple jobs. A Talent Agent asks the AI client for a summary of current work. The MCP runs `list_casting_projects` and provides status updates, letting them manage their assignments without opening the main web portal. ### The database is messy; data standards are unclear. A Production Team lead wants to know what unique metrics they're tracking. They use `list_custom_attributes` and `list_talent_categories` together to get a clear report on the current data structure. ## Benefits - You stop browsing; you start asking. Instead of opening the dashboard to search, simply ask your agent to run `search_talents` with specific criteria—like 'Models tagged athletic'—and get a list back instantly. - Need proof of concept? Use `list_talent_media` to pull up every headshot and video link for a talent ID. This is much faster than navigating file folders manually. - Know what data points matter? Run `list_custom_attributes`. You'll see exactly which unique fields your team has tracked, making sure you never miss important data like 'union status'. - Keep track of the jobs. The agent runs `list_casting_projects` to give you a real-time overview of every active project and its current phase. - Filtering is simple: You can run `list_talent_categories` or `list_talent_tags` first, then feed those results into another query, making your searches highly precise. ## How It Works The bottom line is you talk to your data instead of clicking through menus. 1. Subscribe to this MCP and provide the API key obtained from your Casting42 account settings. 2. Connect the MCP to your AI client (e.g., Cursor, Claude). 3. Ask your agent a natural language question, like 'Show me all models with tag X who are available for Project Y'. ## Frequently Asked Questions **How do I use list_talents with the Casting42 MCP?** You run this tool when you need a general overview of everyone in your database, regardless of specific criteria. It's useful for seeing how many profiles exist and then deciding which subset to query next. **Can I see all available custom fields using list_custom_attributes?** Yes. This tool lists every unique attribute or custom field that your team has defined in the database, ensuring you know exactly what data is being tracked for each talent. **What is the difference between search_talents and list_talents?** Use `list_talents` when you just want a raw count or basic listing of every profile. Use `search_talents` when you have specific criteria—like a name *and* a category—you need to filter by. **How do I get media links using list_talent_media?** You must provide the talent ID first. The tool then retrieves and lists all associated media assets, whether they're headshots or showreel videos. **How do I check my active casting projects using list_casting_projects?** It lists all current casting projects you have set up. You can use this to see the names, associated timelines, and current status of every project in your database. **How do I view the available organizational tags using list_talent_tags?** This tool provides a comprehensive list of all standardized tags used across your talent pool. Knowing these tags lets you filter searches efficiently, ensuring you only pull profiles relevant to specific project needs. **What information does get_talent_details retrieve for a single profile?** It fetches every piece of data stored for one specific talent ID. This includes not just basic contact info, but also access to their custom attributes and associated media links. **How can I view the configured talent categories using list_talent_categories?** This tool shows all predefined categories for your talent base (e.g., actors, models, stunt performers). Using these categories lets you narrow down searches by role type immediately. **Can I search for talents with specific custom attributes?** Yes! You can use the `search_talents` tool. Your agent will query the database and you can then use `get_talent_details` to inspect all custom fields associated with matching profiles. **How do I see the photos and videos for a talent?** Use the `list_talent_media` tool with the talent's unique ID. The agent will return links to all headshots, videos, and self-tapes stored in their profile. **Where do I find my Casting42 API Key?** Log in to your Casting42 account and navigate to the 'Settings' module. You should find your API key there for integration.