# Accela MCP

> Accela MCP connects your AI agent directly to civic services platforms, letting you manage permits, inspections, and land records using natural language. Search for applications, schedule site visits, update statuses, or pull detailed property boundaries without opening a complex government portal.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** permitting, civic-services, inspections, land-management, public-records

## Description

This connector integrates the entire Accela platform into your workflow, giving your AI client direct access to public works data. You manage the full lifecycle of civic services—from initial permit application through final inspection and record keeping. Need to check a parcel's zoning status or find an applicant's contact info? Your agent handles it instantly.

It lets you search for permits and applications, create new records, and update their current status in real time. You can list associated inspections, schedule follow-up site visits, and even pull detailed land parcel maps. Need to manage the people involved? Search or create contractor contacts, then attach necessary documents directly to the record. Whether you're a field inspector verifying details or an analyst pulling jurisdictional data, this MCP lets you handle complex public records right from your chat interface. Vinkius hosts this connection, making all of Accela’s capabilities available through one simple subscription.

## Tools

### create_contact
Adds a new person, organization, or vendor contact into the system.

### create_record
Initiates and creates a brand new civic record, like a permit application file.

### get_parcels
Retrieves specific details about a piece of land or property parcel.

### get_record
Pulls all the detailed information associated with one existing record ID.

### list_documents
Retrieves a list of every document file attached to a specific permit or case file.

### list_inspections
Gets a history or list of all inspections tied to a particular record or inspector's ID.

### schedule_inspection
Books a new site visit date and time for an inspection.

### search_addresses
Finds valid, recognized physical addresses within the local jurisdiction's boundaries.

### search_contacts
Searches for people or companies by name or type (like applicants or contractors).

### search_records
Locates records, like permits or applications, using specific criteria you provide.

### update_inspection
Changes the status or details of a completed inspection report.

### update_record
Modifies general data points on an existing record, like changing a description or owner.

### upload_document
Adds physical documents, such as blueprints or photos, to a specific case file.

## Prompt Examples

**Prompt:** 
```
Search for all building permits with a 'Pending' status.
```

**Response:** 
```
I found 3 pending building permits. The most recent is REC-2024-001 for a residential renovation. Would you like the full details for any of these?
```

**Prompt:** 
```
Schedule a 'Final Plumbing' inspection for record REC-9982 on 2024-12-15.
```

**Response:** 
```
The 'Final Plumbing' inspection for record REC-9982 has been successfully scheduled for December 15, 2024. The confirmation ID is INSP-554.
```

**Prompt:** 
```
Get the detailed information for record ID REC-10293.
```

**Response:** 
```
Retrieving record REC-10293... This is a 'Commercial Electrical' permit issued to 'BuildIt Corp'. Current status is 'Active' and it was last updated on 2024-11-01.
```

## Capabilities

### Permit and Record Management
Search for existing permits or applications, create entirely new records, and update their statuses or descriptions in real time.

### Site Visit Scheduling and Results
List current inspections linked to a record, schedule future site visits, and submit final results directly through your agent.

### Property Boundary Lookup
Search for valid physical addresses within the area and retrieve detailed land parcel information based on those coordinates.

### Contact and Documentation Handling
Find or create contacts like applicants or contractors, and list all documents previously attached to a specific record.

## Use Cases

### Handling a New Development Permit
A developer needs to know if the proposed site is ready for construction. They ask their agent to 'Get parcel data and check zoning.' The MCP runs `get_parcels` and reports back the necessary jurisdictional details, immediately guiding the next steps.

### Closing Out a Site Inspection
A field inspector finishes a plumbing review. Instead of writing notes on paper, they tell their agent to 'Update inspection status to passed for record REC-10293.' The MCP uses `update_inspection` and files the final result.

### Tracking an Old Case File
A planner needs details on a permit from five years ago. They ask their agent to 'Get all documents for application REC-9982.' The MCP executes `list_documents`, compiling everything without the user needing to know which department filed what.

### Onboarding a New Contractor
A manager needs to add a new electrical contractor and their company details. They instruct the agent to 'Add BuildIt Corp as a contact.' The MCP uses `create_contact`, ensuring the data is immediately available for future permits.

## Benefits

- Instead of navigating complex, decade-old web portals, you simply ask your agent to 'Search for all pending plumbing permits.' The system executes the search instantly using `search_records`.
- Need to verify an applicant's details? You just tell your AI client to find them. It uses `search_contacts`, saving you from manually entering names into multiple forms.
- Scheduling site visits is simple: Ask it to book a 'Final Electrical Inspection' for a specific date, and the MCP handles the booking using `schedule_inspection` without any calendar clicks.
- When an inspection is done, don't open 10 tabs. Just tell your agent to update the result, and the system records it instantly via `update_inspection` and logs it on the main record.
- Accessing property data used to require multiple department lookups. Now, you can request detailed land parcel info using `get_parcels` right alongside a simple address search with `search_addresses`.

## How It Works

The bottom line is that you talk naturally to your agent about permits or parcels, and it performs the required actions within the Accela system for you.

1. Subscribe to the Accela MCP on Vinkius.
2. Input your necessary credentials: the Accela App ID, Agency name, and Access Token.
3. Start giving commands to your AI client to manage civic records.

## Frequently Asked Questions

**How do I use Accela MCP to schedule an inspection?**
To book a site visit, simply tell your agent the type of inspection (e.g., 'Final Plumbing') and the date. The MCP executes `schedule_inspection` and confirms the booking ID.

**Can Accela MCP help me find out what documents are attached to a permit?**
Yes, use the `list_documents` tool. You just provide the record ID, and your agent pulls a complete list of every file associated with that specific application.

**What if I need to update an old permit status using Accela MCP?**
You use `update_record`. You tell your agent the Record ID and the new status, and it updates the record immediately in the live system.

**Does Accela MCP work with property boundaries?**
Yes. The `get_parcels` tool allows you to retrieve detailed land parcel information after you first locate a valid address using `search_addresses`.