# Giddyup MCP > Giddyup coordinates entire construction lifecycles for field service teams. It lets you manage everything from initial lead capture to final job dispatching, all through natural conversation. Use your AI client to check job statuses in real-time, list active projects, update crew requirements, and track customer history without touching a spreadsheet. ## Overview - **Category:** construction - **Price:** Free - **Tags:** job-dispatching, route-optimization, lead-management, project-tracking, workforce-management, contractor-tools ## Description Running construction or roofing jobs means juggling dozens of moving parts—leads, crews, materials, billing. This MCP connects directly into your Giddyup account, putting all that data at your fingertips via natural language commands. You tell your agent what you need to know; it handles the lookups and reporting. Whether you're trying to get a full overview of the entire construction pipeline or just checking if the crew for Maple St. Residence has everything they need, this MCP gets it done. It lets your AI client act like an on-site operations manager who knows every job detail. If managing these complex operational workflows is critical, connecting Giddyup through Vinkius gives you one place to manage it all. ## Tools ### check_giddyup_status Verifies that the connection to Giddyup is active. ### create_job Initiates a new construction job record in your system. ### create_lead Adds a new potential customer lead to the directory. ### get_customer Retrieves detailed information for a specific, known customer. ### get_job Pulls all technical details and status updates for a single job ID. ### get_lead Fetches specific data points about a single lead record. ### list_customers Returns a list of all current customers in your directory. ### list_invoices Retrieves a list of billed invoices for accounts. ### list_jobs Lists all active and completed jobs on site. ### list_leads Provides a list view of all collected potential leads. ### list_users Shows the roster and status of your field technicians. ### update_job Modifies specific details, like status or completion date, for an existing job. ### update_lead Changes contact information or status on a specific lead record. ## Prompt Examples **Prompt:** ``` List all active roofing jobs in Giddyup. ``` **Response:** ``` I've retrieved your active projects. You currently have 5 ongoing jobs, including 'Maple St. Residence' and 'Oak Blvd. Commercial'. Would you like the detailed status for any of these? ``` **Prompt:** ``` Show me the latest 3 leads collected this week. ``` **Response:** ``` Scanning leads... I've found 3 new entries from this week: 'John Doe' (Residential), 'Sarah Smith' (Repair), and 'Acme Corp' (Inspection). Which one should I provide contact info for? ``` **Prompt:** ``` Get details for job ID 'J-12345'. ``` **Response:** ``` Fetching job J-12345... This project is for 'Pine Road Apartments'. It's currently in the 'Production' stage with the crew assigned. The estimated completion date is next Friday. Should I check for any pending tasks? ``` ## Capabilities ### Manage Leads Create new potential client records or pull up existing lead details. ### Track Jobs and Projects Get real-time status updates, detailed requirements, and the full history for any active construction job. ### View Customer Directory List or retrieve complete profiles for all your existing customers to coordinate field efforts. ### Review Financials Access and list billing records, including past invoices for the accounts. ### Monitor Staffing See a roster of active technicians to confirm who is assigned to what job. ## Use Cases ### The crew needs a status update before they drive out. A Project Manager asks, 'What's the latest on Maple St. Residence?' The agent uses `get_job` and reports back: 'It’s currently in Production; the estimated completion date is next Friday.' This confirms the crew doesn't waste time driving to a job that isn't ready. ### Sales needs to capture details from a new prospect at a site. The Sales Coordinator uses their agent to call `create_lead` with the name and address of a potential client. Then, they use `get_lead` shortly after to pull contact info for follow-up emails. ### Operations needs to confirm staffing before dispatching. An Operations Director asks, 'Are there enough people available next week?' The agent calls `list_users`, confirming that the necessary number of technicians are free and assigned appropriately for multiple sites. ### The job scope changed mid-project. A Project Manager realizes a specific detail needs fixing. They use their agent to call `update_job` with the new scope and requirements, ensuring all field documentation is current before the crew arrives. ## Benefits - Stop switching between tabs. You can check a job's status or update crew requirements using the `get_job` tool, all through chat. No more manual data entry. - Never lose track of new business. Use `list_leads` and then call `update_lead` to instantly capture contact info for any promising prospect. - Get a full operational picture without opening dashboards. Ask your agent to list active projects using `list_jobs`, and it gives you the status rundown immediately. - Coordination is simple. Pull up customer history with `get_customer` before dispatching a crew, so everyone knows exactly what they're showing up for. - Accountability improves when you can see who’s working where. Use `list_users` to verify which technicians are available or assigned. ## How It Works The bottom line is you talk to your construction CRM using plain English instead of clicking through menus and filling out forms. 1. Subscribe to the Giddyup MCP and retrieve your API Authentication Key from your Giddyup settings. 2. Connect this MCP key into any compatible AI client, like Claude or Cursor. 3. Ask your agent a question—for example, 'What is the status of job J-12345?'—and get an immediate, actionable answer. ## Frequently Asked Questions **How do I check the status of an existing job using the `get_job` tool?** You simply ask your agent for details on the specific job ID. It uses `get_job` to pull the project's current stage, crew assignment, and estimated completion date into your chat. **Can I use `list_customers` to find out who needs service?** Yes. You can call `list_customers` first to see all accounts, then ask the agent about specific customer profiles using `get_customer` for deeper details. **What if I need to update a job's status? Do I use `update_job`?** That’s right. You tell your agent what needs changing—like marking it 'Completed' or changing the date—and it uses `update_job` to write that change back into the system. **Does Giddyup MCP help me with new leads?** Absolutely. You can use your agent to call `create_lead` and capture a promising prospect’s information right away, or check out existing records using `get_lead`. **What information can I get by calling the `list_invoices` tool?** The tool returns a list of all your past invoices. You'll see details like invoice numbers, issue dates, and payment statuses for quick financial oversight. **How do I check which technicians are available using `list_users`?** `list_users` provides a roster of your field staff. You can retrieve names, contact details, and assigned roles to plan crew assignments before dispatching work. **What data do I need to provide when using the `create_job` tool?** You must supply key project information like the service address, scope of work, and initial client details. This starts a new job record in your system. **How can I verify that my connection is working correctly using `check_giddyup_status`?** Running this tool verifies the live connectivity between your AI agent and Giddyup. It confirms that your authentication key works and the platform is operational. **How do I find my Giddyup API Key?** Log in to your Giddyup account and navigate to the **Custom Application Integration** settings to generate your unique authentication key. **Can I list specific roofing jobs by ID?** Yes! Use the `get_job` tool and provide the unique job identifier to retrieve detailed technical data and status updates. **Does this integration support customer profile retrieval?** Absolutely. The `list_customers` tool allows you to retrieve your entire client directory for better field coordination.