# Albi Restoration MCP > Albi Restoration connects your AI client directly to your restoration business management system. You manage projects from initial damage assessment through job completion by having your agent read statuses, pull financial data, and track inventory—all without opening a single field service app. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** albi, restoration-api, project-management-automation, field-service-orchestration, contractor-tools, inventory-tracking, financial-kpis, crm-restoration, mcp ## Description Managing large-scale restoration work usually means jumping between multiple logins: one for project status, another for client contacts, and a third just to check equipment availability. This MCP changes that. Your AI acts as a dedicated coordinator, giving you full control over your entire workflow through natural conversation. You can ask it to pull up all projects needing weekly updates or calculate the gross margin on job 'XYZ' instantly. It also keeps tabs on every piece of gear—from dehumidifiers to air movers—so you know exactly what’s deployed and what needs restocking. Because Vinkius hosts this MCP, your agent connects to this rich source of operational truth, meaning all your project data, financial records, and contact lists are available through one simple chat interface. ## Tools ### check_api_health Verifies the connection status of your Albi API endpoint. ### create_new_contact Adds a new individual contact to your client database. ### create_new_restoration_project Starts and logs a brand-new restoration project, requiring the name and main contact information. ### get_project_financial_kpis Calculates and retrieves key financial metrics (like gross margin) for a given project. ### get_project_details Retrieves all specific details for one particular restoration job. ### list_project_activities Pulls a chronological log of every task or activity recorded for a specific project. ### list_restoration_contacts Retrieves the full directory listing of all contacts you have saved. ### list_inventory_equipment Retrieves a list of all specialized assets and equipment owned by the organization. ### list_restoration_organizations Lists every company or business organization recorded in your system. ### list_restoration_projects Retrieves a list of all restoration projects currently managed by the firm. ### list_defined_project_roles Lists the predefined roles that can be assigned to a project worker or staff member. ### list_configured_webhooks Shows which automated webhooks are currently set up on your account. ## Prompt Examples **Prompt:** ``` List all my active restoration projects in Albi. ``` **Response:** ``` I've retrieved your active projects. You currently have 3 projects in progress, including 'Water Damage - Main St' (ID: proj_123) and 'Fire Restoration'. Would you like the detailed high-fidelity status for any of these? ``` **Prompt:** ``` What are the financial KPIs for project 'proj_123'? ``` **Response:** ``` Accessing financial intelligence... For project proj_123, current revenue is $15,400 with total costs of $8,200, resulting in a high-fidelity gross margin of 46.7%. Need help checking the project activities? ``` **Prompt:** ``` Check my inventory for available dehumidifiers. ``` **Response:** ``` Retrieving equipment list... You currently have 12 dehumidifiers in stock and 5 deployed on active job sites. All assets are within high-fidelity tracking parameters. Shall I list your available air movers? ``` ## Capabilities ### Manage the full project lifecycle The AI can list all active projects and retrieve detailed status updates, staff assignments, and timelines for any given job. ### Calculate financial performance metrics Get specific project data, including current revenue, total costs, and the resulting gross margin percentage. ### Maintain client and vendor records Access and manage your entire database of contacts and organizations to keep communication coordinated across all sites. ### Track specialized equipment inventory Check the availability, location, and status of physical assets and restoration gear used on job sites. ### Review operational activity logs Pull a timeline of project activities, monitor webhooks, and verify API connectivity for instant reporting. ## Use Cases ### Project status update after a meeting A Project Manager needs to know the immediate status of all water damage jobs. They ask their agent to list projects, then follow up by asking for `list_project_activities` on the top two results. This gives them an instant understanding of where every job stands without manually checking 10 different dashboards. ### Determining project profitability An Operations Lead needs to know if a specific fire restoration job was profitable enough for Q2 reports. Instead of diving into complex financial spreadsheets, they query the agent using `get_project_financial_kpis` and get the gross margin percentage right away. ### Onboarding a new client organization A contractor just met a large corporate client. They use the MCP to run `create_new_restoration_project`, naming the job, and then immediately run `list_restoration_organizations` to ensure they are logging the parent company details correctly. ### Inventory check before deployment A site supervisor needs 15 air movers but isn't sure if enough are available. They use the agent to run `list_inventory_equipment`, verify stock, and then confirm what assets are physically deployed via a simple query. ## Benefits - Stop switching between tabs. You can get the project summary using `get_project_details` and immediately follow up by running `list_restoration_projects` to check other job sites, all in one chat thread. - Don't guess at profitability. Running `get_project_financial_kpis` gives you high-fidelity revenue metrics for a project without needing to export data into Excel first. - Keep your CRM clean and accurate. You can use the agent to manage relationships by running `list_restoration_contacts` or creating new entries with `create_new_contact` in minutes. - Never lose track of gear again. Use `list_inventory_equipment` to see what dehumidifiers are available versus what's currently deployed on a job site, streamlining logistics. - Automate reporting by checking project progress using `list_project_activities`. This gives you an instant audit trail for any given restoration site. ## How It Works The bottom line is you tell the AI what you need, and it fetches the correct project data from Albi for you. 1. Subscribe to this MCP on Vinkius and retrieve your Albi API Key from your account settings. 2. Connect that key in your preferred AI client (like Cursor or Claude). 3. Start by asking the agent a question, like 'List all my active restoration projects.' The agent handles the rest. ## Frequently Asked Questions **How do I check if my Albi account connection works with `check_api_health`?** Running `check_api_health` verifies your API key and network status immediately. If the agent confirms a healthy status, you know it's time to start working on projects. **Can I use `list_restoration_projects` to see all my jobs?** Yes. Running `list_restoration_projects` gives you the names and IDs of every restoration job managed by the firm, letting you pick which one you want details for. **What is the best way to track equipment with `list_inventory_equipment`?** You run `list_inventory_equipment` and ask the agent to filter or count specific items, like 'Show me all available dehumidifiers.' This gives you an immediate asset inventory count. **What if I need to start a new project? Which tool should I use?** Use `create_new_restoration_project`. You just provide the name and primary contact through your agent, and it handles logging the entire job into Albi. **How do I check project profitability using `get_project_financial_kpis`?** You pass the project ID to retrieve detailed financials. The tool returns current revenue, total costs, and the gross margin percentage. This gives you an instant view of a job's financial health without checking multiple spreadsheets. **When I use `create_new_contact`, what information must I provide to ensure data quality?** You need at minimum the contact name, type (individual or organization), and primary email address. Providing job titles or company identifiers helps link the new record accurately into your existing client database. **If I want a full history of what happened on a site, how does `list_project_activities` help?** It pulls every recorded task and action associated with that project. This list tracks everything from initial damage assessments to staff check-ins, giving you a complete audit trail for the job. **What does `list_configured_webhooks` show me about my system integrations?** This tool lists all active webhooks connected to your account. It lets you monitor which external systems are communicating with Albi and confirms that your automated processes are running correctly. **How do I find my Albi API Key?** Log in to your account, navigate to **Settings** > **Integrations**, and click the 'API Key' button to generate or copy your unique token. **Can I track financial KPIs via AI?** Yes! The `get_project_financial_kpis` tool allows your agent to retrieve high-fidelity revenue, cost, and margin data for any specific project ID. **How do I check available inventory?** Use the `list_inventory_equipment` tool to retrieve a complete high-fidelity list of all physical assets and specialized gear managed in your account.