# CompanyCam MCP MCP > CompanyCam helps your AI agent manage jobsite documentation, projects, and high-resolution photos. It lets you list, search, and retrieve project records by name or address. You can pull specific photo details, check GPS coordinates on site media, or quickly generate a full list of active construction projects without opening the mobile app. ## Overview - **Category:** document-management - **Price:** Free - **Tags:** jobsite-photos, project-documentation, gps-tagging, photo-annotation, field-operations ## Description Working with jobsite documentation used to mean juggling multiple apps: logging into one system for photos, another for documents, and yet a third for project status. Now, you can connect your AI client directly to CompanyCam, turning those manual steps into natural conversations. Instead of manually navigating folders or searching through dozens of files, you simply ask your agent what you need—for instance, 'Show me all the roof photos from 123 Oak Street.' The MCP pulls that data instantly, giving you a complete view of project status and media assets in one chat window. This integration lives right inside the Vinkius catalog alongside thousands of others, letting your team access everything needed for field operations without switching screens or logging into five different systems. You get immediate answers about who is on site, what photos were taken, and which documents are attached to a specific job. ## Tools ### create_project Starts a new job site record in CompanyCam. ### get_current_user Retrieves the details of the user who is currently authenticated to the system. ### get_photo_details Pulls specific metadata, like timestamps and GPS coordinates, for a single photo file. ### get_project Retrieves detailed information about one known project site. ### list_all_photos Gets a list of every photo stored across all projects in the company account. ### list_project_documents Retrieves a list of files attached to a specific project site. ### list_project_photos Gathers all photos associated with one specific jobsite. ### list_projects Retrieves a list of every project managed within CompanyCam. ### list_users Gets a full roster and details for all user accounts in the company. ### search_projects Finds an existing project quickly using keywords like name or address. ## Prompt Examples **Prompt:** ``` Show me the first 20 projects in CompanyCam. ``` **Response:** ``` Here are your first 20 projects: 1. '123 Oak Street Roof' — 48 photos, last updated today 2. 'Downtown Office Remodel' — 125 photos, last updated yesterday 3. 'Elm Park Siding' — 22 photos, last updated 3 days ago ... Would you like to see photos for any of these? ``` **Prompt:** ``` List all photos for project 'proj-xxxx'. ``` **Response:** ``` Project 'proj-xxxx' has 48 photos: 1. Front Exterior — taken Jan 15, 10:32 AM (GPS: 41.88, -87.63) 2. Roof Detail — taken Jan 15, 10:45 AM (GPS: 41.88, -87.63) 3. Interior Kitchen — taken Jan 15, 11:02 AM Would you like me to filter by date or tag? ``` **Prompt:** ``` Create a new project at '456 Maple Drive'. ``` **Response:** ``` Project successfully created! - Name: 456 Maple Drive - Status: Active - ID: proj-9y8z You can now start uploading photos to this jobsite. ``` ## Capabilities ### Find Projects Quickly list all projects or search for a project by name or address. ### Manage Project Files Create new job sites and retrieve detailed information about existing projects, including their documentation. ### Audit Site Media Pull comprehensive lists of all photos across your company or focus on specific images to view timestamps and GPS data. ### Review Documentation Get a list of documents attached to any given project for quick review. ### Check Team Credentials View details about the currently logged-in user or retrieve a full roster of company users and their roles. ## Use Cases ### Auditing a new job site A project manager needs to see all documentation for 'Downtown Office Remodel'. They tell their agent, 'Get the documents and photos for Downtown Office Remodel.' The agent uses `search_projects` first, then calls both `list_project_photos` and `list_project_documents`, giving a single consolidated report right in the chat. ### Verifying team roles An office staffer needs to know which users are authorized for the 'Elm Park Siding' project. They ask their agent, and it uses `list_users` to provide a complete list of names and access levels. ### Starting work on a new build A contractor arrives at a new address. Instead of filling out paper forms, they simply ask their agent to 'Create a new project for 456 Maple Drive.' The MCP uses `create_project`, generating the site ID and confirming it's ready for photo uploads. ### Cross-referencing details A field worker wants to confirm when a specific roof detail photo was taken. They tell their agent, 'What are the GPS coordinates for the roof detail photo from 123 Oak Street?' The MCP uses `get_photo_details` and returns the precise metadata. ## Benefits - Stop opening the mobile app just to check project status. Your agent can now use `list_projects` or `search_projects` to give you a quick overview of every active site and its current documentation count. - Never lose context when reviewing jobsite media. You can ask your AI client to pull all photos for one location using `list_project_photos`, and then get detailed GPS data on any specific image with `get_photo_details`. - Proposal generation gets faster. Instead of manually locating supporting images, use the MCP to retrieve project documentation or list user roles via `list_users`, giving you exactly what your client needs for a report. - Project setup is simple. If you know where work starts, run `create_project` in natural language and instantly get an active jobsite ID ready for photo uploads. - Team management is streamlined too. Need to verify who has access? Run `list_users` or check the current user's details using `get_current_user` without opening a separate directory. ## How It Works The bottom line is, you talk to the MCP, and it pulls the jobsite data right into your conversation. 1. Add the CompanyCam integration to your AI toolset on Vinkius. 2. Provide your Access Token (you find this under Your Company > Account > Access Tokens). 3. Use natural language commands like 'List all projects' or 'Show me photos for 456 Maple Drive' in your chat. ## Frequently Asked Questions **How do I find a project using the `search_projects` tool?** You use natural language to ask your agent to search projects by name or address. The MCP handles the query, so you don't have to know the exact internal ID. **What does `list_project_photos` do?** `list_project_photos` retrieves every photo tied to a single project. This is better than listing all photos because it keeps your scope focused on one jobsite at a time. **Can I create a new site using `create_project`?** Yes, the MCP allows you to start a brand-new project record in CompanyCam by calling `create_project`. It initializes the jobsite and gives you an active ID right away. **Is `list_users` different from `get_current_user`?** `list_users` shows you everyone in the company roster. Use `get_current_user` when you only need to verify your own account details. **How do I get detailed info on a photo? (Using `get_photo_details`)** You must provide the specific photo ID or project context. Then, calling `get_photo_details` pulls metadata like GPS coordinates and timestamps that are critical for field reports. **What does `list_project_documents` handle? Does it list invoices or reports?** It retrieves a list of documents attached directly to the project. This includes files like blueprints, compliance certificates, and general site reports that aren't photos. **If I need pictures from every jobsite, not just one, how do I use `list_all_photos`?** `list_all_photos` pulls together photo records across all projects in your company account. This is useful for auditing or compiling a global set of visual evidence. **What specific data points can I get using the `get_project` tool?** This function provides detailed metadata about an entire jobsite, going beyond just its name. You'll retrieve status details, key dates, and high-level project identifiers. **How do I get my CompanyCam Access Token?** In the CompanyCam web app, go to **Your Company > Account > Access Tokens** and generate a new token. Copy it and paste it below. **What is a project in CompanyCam?** A project is a container for a specific jobsite where you store photos, documents, and comments related to that location. **Can I upload photos with this integration?** The current version focuses on browsing and retrieving project data and photos. Photo uploading may be added in future updates.