# Gripr MCP > Gripr manages safety compliance, project timelines, and labor tracking for construction sites. Use this MCP to let your AI agent handle everything from listing active job sites to logging specific work hours and generating required HSE/QA reports through natural conversation. ## Overview - **Category:** construction - **Price:** Free - **Tags:** safety-compliance, risk-assessment, time-tracking, craft-industry, project-monitoring, mobile-field-tools ## Description This connector lets you take control of complex field operations without clicking through ten different tabs or filling out forms by hand. You connect it via Vinkius, giving your AI client access to all the data inside Gripr—your project history, customer contacts, and site compliance records. Your agent acts like a dedicated site manager. Need to update a task status? Just ask. Working overtime on a specific job? Register the hours directly. When you need to know which forms are required for a certain type of work, your AI gets that list instantly. It moves project oversight from manual data entry and spreadsheet juggling straight into conversation. ## Tools ### create_customer Adds a completely new client record into the system's database. ### create_project Sets up and launches an entirely new construction project profile. ### create_task Adds a specific, actionable task to an existing project's checklist. ### get_project_details Pulls up all the technical information and status updates for one specific project ID. ### list_customers Retrieves a list of every customer currently registered in Gripr. ### list_forms Shows which HSE or QA forms are required for compliance checks. ### list_registered_hours Displays a history report of all logged work hours across multiple sites. ### list_projects Lists all active and completed construction projects in the account. ### list_tasks Retrieves an optional list of tasks, which can be filtered by a specific project ID. ### list_workspace_users Shows all user accounts that are part of the current work environment. ### register_hours Inputs and logs a specific amount of work time against a project for accurate billing records. ## Prompt Examples **Prompt:** ``` List all my active construction projects. ``` **Response:** ``` I've retrieved your active projects. You have 3 ongoing works: 'Oslo Waterfront' (ID: p_123), 'Mountain Cabin' (ID: p_456), and 'City Hub' (ID: p_789). Which one would you like to update? ``` **Prompt:** ``` Register 120 minutes of work for project 'p_123' today. ``` **Response:** ``` Time registered! I've added 120 minutes to the 'Oslo Waterfront' project for today's date. The entry is now logged in your Gripr history for billing. ``` **Prompt:** ``` Show me a list of all customers in Gripr. ``` **Response:** ``` Scanning customers... I found 5 registered clients, including 'Acme Corp' and 'Global Builders'. Would you like the contact details for any specific customer? ``` ## Capabilities ### Manage Project Status List all current projects or retrieve specific technical details on any single job site. ### Track Labor Hours Register work hours against a project and view historical time logs for accurate billing. ### Handle Compliance & Safety Forms Access required HSE (Health, Safety, and Environment) and QA (Quality Assurance) forms directly through the agent. ### Coordinate Tasks and Projects Create new project tasks or manage a list of scheduled activities for any given site. ### Maintain Client Records View all customer profiles, list existing contacts, or create brand-new client accounts within Gripr. ## Use Cases ### The Site Supervisor Needs to Log Time A supervisor finishes a day at the 'City Hub' site. Instead of logging into a separate web portal, they ask their agent: 'Register 8 hours for project p_789 today.' The AI handles the `register_hours` call and confirms the entry is logged for billing. ### The PM Needs to Start a New Job A Project Manager gets a new contract. They ask their agent to 'Create a project for the Mountain Cabin.' The AI uses `create_project`, and then they immediately follow up by asking it to list all required safety forms using `list_forms`. ### The Owner Needs Client Data An owner needs contact information for a client. They ask the agent to 'Show me all customers.' The AI uses `list_customers`, giving them the names, and they can then request detailed records on any specific account. ### The Team Needs a Quick Status Check A team member needs to know what tasks are pending for a job. They prompt: 'List all outstanding tasks for p_456.' The AI uses `list_tasks`, giving them the immediate action items, saving them from navigating the project dashboard. ## Benefits - Stop manually updating task lists. You can use your agent to create a new project using `create_project`, then add actionable steps with `create_task`—all in one chat session. - Never lose track of who you talked to. Use `list_customers` and then `get_project_details` to pull up contact info and site status simultaneously, without switching screens. - Time logging is fast. Instead of opening a separate timesheet app, just tell your agent the hours; it uses `register_hours` and logs it directly into your billing history. - Compliance checks are instant. You can use `list_forms` to see what's required for a job, then ask the AI to pull up those forms for immediate review. - Keep track of everything with one view. By listing projects via `list_projects`, you get an overview, and then drill down into specifics using `get_project_details`. ## How It Works The bottom line is you talk to your AI client about your construction work instead of clicking through dashboards. 1. Subscribe to this MCP and retrieve your API key from your Gripr account settings. 2. Connect the key to your preferred AI agent in Vinkius, authorizing access to all project data. 3. Use natural language commands with your agent. For example, ask it to 'register 8 hours for the Oslo Waterfront site' or 'list all active projects'. ## Frequently Asked Questions **How does I use the `register_hours` tool with Gripr MCP?** Just ask your agent directly for time logging. Say something like, 'Register 16 hours of work for project p_789.' The AI uses `register_hours` and logs the entry immediately against that specific job ID. **What is the difference between `create_project` and `list_projects`?** `create_project` sets up a brand new site or contract in Gripr. Meanwhile, `list_projects` just fetches a list of every existing job you have on file. **Can I use the Gripr MCP to find required safety forms?** Yes. You can ask your agent to run `list_forms`. It will show you which HSE or QA compliance documents are necessary for a job, keeping your site safe and legal. **How do I create a new customer record with the Gripr MCP?** To add a client, ask your agent to run `create_customer`. You'll provide the name and contact details in plain language, and it handles the API call. **What credentials do I need before I can use the `list_projects` tool?** You must provide a valid API key generated from your Gripr account settings. This credential authenticates your AI agent to the system, allowing it to access and read project data across your organization. **How can I get all tasks associated with a specific project ID using `list_tasks`?** You pass the required Project ID as a filter parameter when invoking `list_tasks`. This ensures the agent only returns work items directly linked to that single project, preventing data overload. **What happens if I try to use `create_task` for an invalid or non-existent project?** The system will return a validation error. This means the Project ID you provided does not match any active records in your Gripr account, forcing you to correct the reference before proceeding. **Can I see which users are currently set up in my workspace using `list_workspace_users`?** Yes, running `list_workspace_users` retrieves a list of every user associated with your Gripr account. This view confirms who has access and helps you manage internal roles. **How do I find my API Key in Gripr?** Log in to your Gripr account and navigate to **Settings** > **Integrations / API** to generate your unique key. **Can I register hours for a specific project?** Yes! The `register_hours` tool allows you to provide the `projectId`, duration in minutes, and a description for each entry. **How do I access compliance forms?** Use the `list_forms` tool to retrieve a directory of all available HSE and QA forms configured in your workspace.