# Towio MCP > Towio MCP Server coordinates field service operations. Use this to list active construction projects, track job-site tasks, query staff details, and monitor material delivery documents through natural conversation with your AI client. ## Overview - **Category:** erp-operations - **Price:** Free - **Tags:** field-service, dispatch-management, gps-tracking, logistics, workforce-management, job-scheduling ## Description This server hooks your AI client up to Towio, giving you the power to manage site operations right from your chat window. Forget logging into a dozen different portals; just talk to your agent, and it handles all the heavy lifting for field work. **Managing Projects:** You can get a rundown of every active construction job tracked in the system by calling `list_projects`. Need to know what's going on? That tool pulls all the core project metadata. It’s how you keep tabs on everything from start to finish, making sure nobody gets lost in paperwork. **Task Tracking and Coordination:** When it comes to work crews, your agent handles tasks like a pro. You can call `list_tasks` to see every single job-site task logged across the entire company. If you need to check what's due next week on Site B versus Site D, this is where you look. Better yet, if something pops up that needs doing immediately—say, a busted piece of equipment or an unexpected inspection—you just use `create_task`, and it drops the new work item straight into Towio for whoever needs to see it. **Workforce Details:** Need to know who's on site or what their role is? You can query staff details using `list_employees`. This gives you a complete list of company personnel, including their specific roles and contact info. It keeps your records straight so you always know who needs to be where. **Material Deliveries:** Don't let materials get lost in transit or on site. You can monitor all incoming goods by calling `list_delivery_documents`. This tool gathers every recorded delivery note along with the associated tracking papers, letting you verify that the supplies arrived safe and sound—exactly when they were supposed to. **System Status:** Before you start talking shop, you should check the connection. You can always run `get_api_version` to confirm the current connectivity status and API version number of the Towio endpoint. This helps make sure your agent's conversation doesn't hit a brick wall because something broke on their end. Your AI client uses these tools—`create_task`, `list_tasks`, `list_employees`, `list_projects`, `list_delivery_documents`, and `get_api_version`—to act as your single source of truth for field operations. You're not just looking at data; you're making the system *do* things, whether it’s creating a task or pulling up a list of workers. ## Tools ### list_projects Retrieves metadata for every project tracked within your Towio account. ### list_tasks Lists all tasks currently logged across the entire company's job sites. ### create_task Adds a new task record directly into the Towio system for any given project. ### get_api_version Checks the current connectivity status and version number of the Towio API endpoint. ### list_delivery_documents Retrieves a list of all recorded material delivery notes and associated tracking documents. ### list_employees Gets a comprehensive list of company employees, including their roles and details. ## Prompt Examples **Prompt:** ``` List all active projects in my Towio workspace. ``` **Response:** ``` I've retrieved your projects. You have 3 active construction sites: 'Central Park Renovations', 'Skyline Tower B', and 'Riverside Craft'. Which one would you like to check tasks for? ``` **Prompt:** ``` Show me the task list for the 'Skyline Tower B' project. ``` **Response:** ``` I've fetched the tasks. There are 5 pending items including 'Plumbing Inspection', 'Material Delivery Check', and 'Electrical Wiring'. Shall I add a new task to this list? ``` **Prompt:** ``` Create a task: 'Order 50 bags of cement' for project '88231'. ``` **Response:** ``` Success! The task 'Order 50 bags of cement' has been created for project 88231. I've logged it in your towio workspace. Would you like to assign an employee to it? ``` ## Capabilities ### List all active projects Retrieve a list of every construction project currently tracked in the system. ### Get task lists and create tasks Fetch existing to-dos for any site, or instantly add new work items to keep crews accountable. ### Query employee details Look up staff names, roles, and contact info across your entire workforce. ### Monitor material deliveries List all recorded delivery notes and associated documents to verify materials arrived safely. ## Use Cases ### Need to check if the right materials arrived. A Site Supervisor needs to know if the cement shipment got here before starting. They tell their agent: 'Check delivery documents for Project 45.' The agent calls `list_delivery_documents`, confirming the material arrival status, and gives them a pass or fail signal immediately. ### Need to scope out a new site's work. A Planner wants to see what projects are running this quarter. They ask the agent to `list_projects`. The agent returns all active sites, allowing them to select one and then run `list_tasks` to understand the current workload. ### Need to assign a new follow-up task. The Ops Manager realizes an inspection is due next week. They ask the agent: 'Add a plumbing check for Skyline Tower B.' The agent uses `create_task`, logging the required action and ensuring it appears on the site's schedule. ### Need to coordinate staff availability. The Project Manager needs three electricians. They ask the agent: 'Who are the available electrical crew members?' The agent executes `list_employees`, filtering the list down to only qualified and currently available personnel. ## Benefits - **Instantly track project status.** Instead of logging into the dashboard to see what's active, ask your agent to `list_projects` and get a clean summary right away. It cuts out three clicks. - **Streamline task assignment.** Need to add a reminder? Use `create_task`. You just tell the AI what needs doing—it handles logging it against the correct project ID for you. - **Verify staff readiness.** Before a crew hits the site, use `list_employees` to check if key personnel are available. No more calling HR separately; the data is right here. - **Confirm material flow.** Don't guess where supplies are. Run `list_delivery_documents` and get a verified list of all materials received for job sites. - **Keep everything centralized.** With tools like `list_tasks`, you can pull every single to-do item from across multiple projects in one go, giving you a total view of site workload. ## How It Works The bottom line is that your AI client treats Towio like an extension of its own memory, letting you talk to your job site data. 1. Subscribe to the server and provide your Towio API Token. 2. Tell your AI client what you need—for example, 'Show me overdue tasks for the Central Park site.' 3. The agent executes the necessary tools (`list_tasks`, `list_projects`) and returns a direct list of items or status updates. ## Frequently Asked Questions **Can I see all the employees registered in our Towio account?** Yes! Use the `list_employees` tool. Your agent will retrieve the complete directory of staff members registered in your workspace. **How do I create a new task for a project via AI?** Use the `create_task` tool. Provide a title, an optional description, and the Project ID. The agent will instantly add the task to your workspace. **Is it possible to see recent delivery documents?** Absolutely. Use the `list_delivery_documents` query to retrieve a list of all recent delivery notes and associated files tracked in Towio. **How do I check the connection status before using any tool, like listing projects with `list_projects`?** You run the `get_api_version` tool to confirm connectivity immediately. This call verifies your API token and reports the current system version number. If the version is returned without an error, your client can proceed with all other operations. **What happens if I try to run `create_task` but don't specify a project ID?** The agent will return a validation error. The task requires a specific parent project identifier to log it correctly. You must use the output from `list_projects` first, then include that ID when calling `create_task`. **Does running `list_projects` handle large numbers of active construction sites?** Yes, the tool supports pagination. If your workspace has many projects, the agent will retrieve results in batches and prompt you to request the next page until all entries are listed. **What is the proper way to authenticate my AI client before I can use `list_employees`?** You must first secure your API token from your Towio workspace settings. Your agent uses this token for authorization; make sure it's active and correctly passed in the connection parameters. **If I need to find all pending tasks for a specific project, do I use `list_tasks` or `list_projects`?** You should use `list_tasks`. This tool lets you filter and retrieve job-specific items. You'll typically pass the desired Project ID from your `list_projects` results to narrow down the task list.