# TurfHop MCP for AI Agents AI Agent Connect > TurfHop MCP lets you manage your lawn care and landscaping business through your AI agent. Handle customer records, schedule jobs, track invoices, and browse your service catalog without leaving your chat interface. It's built for field service operations that need to move faster. ## Overview - **Category:** erp-operations - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_IeqhX7sMYtzznnKMo8NuVbM0Jurjn5fjnRhdDJoG/ai-agent-connect - **Tags:** lawn-care, scheduling, route-planning, billing, service-management, work-orders ## Description Managing a landscaping business usually feels like a constant game of whack-a-mole. You're constantly switching between a scheduling app, a billing tool, and a customer database just to see if a job is done or if a client paid their last bill. It's a lot of tabs to keep open and even more data to keep straight in your head. This TurfHop connection lets your AI agent do the heavy lifting. Instead of clicking through five different screens, you can just ask your agent to pull up a customer's history or check the status of a quote. It puts your entire operation into a single conversation, so you can focus on the actual work. Because Vinkius hosts this connection, you can pull all your data into your daily workflow without manual data entry. It makes coordinating a mobile workforce feel like a conversation rather than a chore. You get a clear view of your cash flow and your team's schedule in one place, letting you focus on growing the business instead of fighting with your software. ## Tools ### create_customer Add a new client to your system. Pass the data as a JSON string to build a new profile. ### create_job Set up a new service assignment. Use this to put a new job on the calendar immediately. ### get_invoice See the specifics of a single invoice. Use this to check payment dates and amounts. ### get_job Pull up the specific details for a single service job. Use this to see what needs to be done at a specific location. ### list_customers Get a full list of everyone in your database. This helps you see your entire client base at a glance. ### list_invoices See all your outstanding and paid invoices. Use it to track your company's current cash flow. ### list_jobs View every service job currently in your system. It's the fastest way to see what's on the schedule. ### list_quotes See all the quotes you've sent out. This helps you track potential new business. ### update_job Change the status or details of a service job. It's perfect for marking a job as complete. ### get_customer Look up a specific customer's details using their ID. This is how you find specific account info fast. ### list_products Browse your entire list of services and products. Use this to check pricing and availability quickly. ### update_customer Edit existing customer information. Use this to keep your records accurate as client needs change. ## Prompt Examples **Prompt:** ``` Who hasn't paid their invoice this month? ``` **Response:** ``` I've checked your recent billing records. Here are the outstanding invoices: | Invoice # | Customer | Amount | Status | | :--- | :--- | :--- | :--- | | #INV-8823 | John Doe | $250.00 | Sent | | #INV-8824 | Smith Residence | $45.50 | Sent | Would you like me to send a reminder to either of these customers? ``` **Prompt:** ``` What's the status of the Smith residence job? ``` **Response:** ``` The job for **Smith Residence** is currently marked as **In Progress**. * **Task**: Gutter Cleaning * **Assigned Crew**: Team B * **Status**: 65% Complete I can update this to 'Complete' if you'd like. ``` **Prompt:** ``` Add a new customer named Sarah Jenkins at 123 Oak St. ``` **Response:** ``` Done! I've created a new customer profile for **Sarah Jenkins** at **123 Oak St**. * **Customer ID**: cust_9921 * **Status**: Active Would you like to schedule a first-time lawn service for her now? ``` ## Capabilities ### Create new customer profiles Add new clients to your database with a few words. ### Pull up full service histories See every previous job and interaction for a specific client. ### Schedule new service assignments Put new work orders on the calendar immediately. ### Update job statuses in real-time Mark jobs as complete or in progress from your chat. ### Check invoice and quote statuses See what's paid, what's pending, and what's still out for quote. ### Browse your full product catalog Check your service offerings and pricing at any time. ## Use Cases ### Checking pending quotes for new leads A client calls to ask about a pending quote. Ask your agent to use list_quotes to find the estimate and then get_customer to see their history. ### Updating job completion in the field A crew finishes a mowing job. Tell the agent to use update_job to mark it complete and move to the next one. ### Identifying unpaid invoices You need to see who hasn't paid this month. Ask the agent to use list_invoices and filter for unpaid statuses. ### Booking a new lawn treatment A new lead wants a lawn treatment. Use list_products to check pricing and create_job to book the first visit. ## Benefits - Stop digging through menus to find client history by using list_customers and get_customer to see everything in one view. - Keep your crew moving by using list_jobs and update_job to see and change statuses in real-time without opening a browser. - Get a faster handle on your cash flow by using list_invoices to see what's paid and what's still outstanding. - Create new work orders instantly with create_job so you can get your team on-site faster. - Quickly check your pricing and service availability using list_products to give accurate quotes to new leads. - Build your client base faster by using create_customer to add new profiles as soon as you sign them. ## How It Works The bottom line is it turns your landscaping management software into a conversational command center. 1. Subscribe to the TurfHop MCP on Vinkius. 2. Enter your TurfHop API Key from your account settings. 3. Ask your AI agent to list jobs or check invoices. ## Frequently Asked Questions **Can the TurfHop MCP manage my lawn care schedule?** Yes, it lets you list all current jobs and update their statuses in real-time. You can see what your crew is doing and move assignments around just by talking to your agent. **How does TurfHop MCP help with billing?** It gives your agent the ability to see all your invoices and quotes. You can quickly check who owes you money or see the status of a pending quote without opening your billing software. **Can I use TurfHop MCP to add new clients?** Yes, you can create new customer profiles directly through your AI agent. Just tell the agent the customer's name and address, and it handles the data entry for you. **Does TurfHop MCP work with Claude?** Yes, it works with Claude, Cursor, Windsurf, and any other MCP-compatible client. You just connect it once and can use it across your favorite tools. **How do I connect TurfHop to my AI agent?** Once you subscribe on Vinkius, you'll just need to enter your TurfHop API Key from your account settings. From there, your agent can start accessing your jobs and customer data. **Can I check my service pricing with TurfHop MCP?** Yes, the Connector can browse your full list of products and services. This makes it easy to check your current pricing and availability when talking to new leads. **Can I search for a customer by their name?** Yes! Use the `list_customers` tool. While it returns the full list, you can ask the AI agent to find a specific person or retrieve details for a specific ID using `get_customer`. **How do I schedule a new service job via AI?** Use the `create_job` action. You'll need to provide a JSON string containing the job details like `customer_id`, `title`, and `start_date` to register the new assignment. **Is it possible to see the payment status of an invoice?** Absolutely. Use the `get_invoice` tool and provide the Invoice ID. The agent will retrieve the complete metadata, including whether the invoice is paid, pending, or overdue.