# Avaza MCP for AI Agents MCP

> Avaza connects your AI client directly to professional services operations. This MCP lets you automate the entire service lifecycle, handling everything from project setup and task creation to logging accurate time entries and pulling recent invoices—all through natural conversation.

## Overview
- **Category:** customer-relationship-management
- **Price:** Free
- **Tags:** time-tracking, invoicing, resource-scheduling, task-management, professional-services, billing

## Description

Manage complex projects without jumping between tabs or applications. This Avaza connector gives your AI agent control over your entire professional services workflow, allowing you to handle tasks using simple chat commands. You can ask it to list all current projects, create a new task for an overdue item, and then log the corresponding time spent on that job, all in one go.

It's about centralizing visibility. Need to know the status of a client relationship? Your agent can pull company contacts or check recent invoices against project timelines. This capability is critical because it keeps your team aligned and ensures billing matches actual effort. With Vinkius hosting this MCP, you just connect once from any compatible AI client, and suddenly all these operations are available to your agent.

## Tools

### create_project
Sets up a brand new project within Avaza.

### create_task
Adds a specific task to an existing project.

### create_timesheet
Records a new entry of time spent working on a job.

### get_account_check
Verifies that the Avaza account is connected and authenticated for use.

### get_project
Retrieves detailed information about a single, specific project.

### list_contacts
Pulls a list of company contacts and user details associated with the account.

### list_invoices
Retrieves a list of recent invoices for financial review.

### list_projects
Lists every project currently active in the Avaza account.

### list_tasks
Lists all tasks across the entire platform.

### list_timesheets
Retrieves a comprehensive list of past timesheet entries.

### update_task
Modifies details on an existing, open task.

## Prompt Examples

**Prompt:** 
```
List all current projects and show me which ones have tasks that haven't been updated in over two weeks.
```

**Response:** 
```
**Project Status Report**

*   ✅ Website Redesign: Active. Last task update: 3 days ago.
*   ⚠️ Q4 Marketing Strategy: Needs attention. Tasks listed below are stale.
*   ⏳ Client Onboarding: Pending review. Next action due in 1 week.

**Stale Task Details (Q4 Marketing Strategy):**
- Campaign Budget Approval: Assigned to John Doe. Last updated: Oct 12, 2023.
- Media Kit Draft: Assigned to Jane Smith. Last updated: Oct 5, 2023.
```

**Prompt:** 
```
I spent 4 hours today working on the Client Onboarding project. Can you log that and update the task status?
```

**Response:** 
```
**Timesheet Entry Success!**

*   ✅ **Project:** Client Onboarding (ID: 54321)
*   📅 **Date Logged:** Today's Date
*   ⏱️ **Hours Added:** 4.0 hours
*   📊 **Total Hours for Project:** Updated to [New Total]

The time sheet entry is live, and the task status has been updated accordingly.
```

**Prompt:** 
```
What are our top three clients we've worked with recently? I need their contact info.
```

**Response:** 
```
**Top Client Contacts**

Here are details on your most recent or active accounts:

*   🏢 **Acme Corp:** CEO: Robert Smith | Phone: (555) 123-4567 | Status: Active
*   🏢 **Global Dynamics:** Contact: Sarah Connor | Email: sarah@global.com | Status: Leads
*   🏢 **Innovate Solutions:** Primary contact: Mark Lee | Billing ID: INV9001
```

## Capabilities

### Create New Projects
Sets up a brand new project within Avaza.

### Add Tasks to Projects
Adds a specific task to an existing project.

### Record Time Spent
Records a new entry of time spent working on a job.

### Verify Connection
Verifies that the Avaza account is connected and authenticated for use.

### Get Project Details
Retrieves detailed information about a single, specific project.

### List Contacts
Pulls a list of company contacts and user details associated with the account.

### Retrieve Invoices
Retrieves a list of recent invoices for financial review.

### List All Projects
Lists every project currently active in the Avaza account.

### List Tasks Overview
Lists all tasks across the entire platform.

### List Timesheets History
Retrieves a comprehensive list of past timesheet entries.

### Edit Task Status
Modifies details on an existing, open task.

## Use Cases

### Client Billing Review
A consultant needs to check if a client's recent invoices match the scope of work. They ask their agent, 'Show me the last five invoices and all open projects for Acme Corp.' The agent uses `list_invoices` and `list_projects`, providing an immediate financial comparison.

### End-of-Week Reporting
An Operations Manager needs to prepare a weekly report. They ask the agent to 'List all outstanding tasks for the marketing department.' The agent uses `list_tasks` and identifies stale items needing follow up.

### Onboarding New Workflows
A team lead starts a new client engagement. Instead of creating it manually, they prompt the agent to 'Create a project called Website Redesign' and then use `create_task` to set up initial milestones.

### Catching Up on Hours
A team member realizes they forgot to log time. They simply tell their agent, 'Log 6 hours for the Client Onboarding project today.' The agent uses `create_timesheet` and updates the record instantly.

## Benefits

- Stop context switching. You can log time entries using `create_timesheet` right where you are chatting, without ever leaving your agent's interface.
- Gain instant visibility into financials. Use `list_invoices` or `list_contacts` to pull client data and billing history immediately when needed.
- Keep teams aligned easily. Your agent can list all projects (`list_projects`) and tasks (`list_tasks`), giving you a real-time status report instantly.
- Accurate resource management is simple. By logging time with `create_timesheet`, you ensure every minute spent is properly accounted for billing.
- Never lose track of scope. You can retrieve full project details using `get_project` to keep the entire history and task list in one place.

## How It Works

The bottom line is that once connected, your AI client treats Avaza like another app it can talk to directly, eliminating manual data entry and context switching.

1. Subscribe to this MCP on Vinkius and provide your Avaza Personal Access Token.
2. Connect your preferred AI client (Claude, Cursor, etc.) using the integrated credentials.
3. Tell your agent what you need: 'List all projects for Q2' or 'Log 4 hours for Project X'. The MCP handles the rest.

## Frequently Asked Questions

**How does the Avaza MCP help me manage projects and billing?**
It connects your AI agent directly to all your project data, allowing you to start tasks, log time, and check invoices without leaving your chat. It centralizes operations so you don't have to switch between multiple tabs or tools.

**Can I use the Avaza MCP if my team works in different locations?**
Yes. Since it manages all project and task coordination, your AI agent acts as a central hub for reporting status updates across time zones, ensuring everyone has the latest information instantly.

**Does Avaza MCP help me track billable hours accurately?**
Absolutely. You can use natural language to log time entries (`create_timesheet`) and list all past timesheets, giving you an accurate audit trail of every minute worked on a project.

**What kind of information can I get about my clients?**
You can retrieve full company contact lists using `list_contacts` or pull specific financial details by listing recent invoices, giving you instant visibility into billing history and contacts.

**Is Avaza MCP better than just using the native Avaza dashboard?**
It's faster. Instead of navigating complex menus in the dashboard, you simply ask your AI agent what you need—like 'Show me all projects' or 'Create a new task'—and it executes the command immediately.