# Magicplan MCP for AI Agents AI Agent Connect

> Magicplan MCP lets you talk to your floor plans and project estimates using natural language. It connects your architectural workspace to your AI client so you can pull area measurements, room details, and material costs without jumping between tabs. It's built for anyone who needs to turn spatial data into actionable project info quickly.

## Overview
- **Category:** real-estate
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_1iwfIzFwMTO22VAK6IG7VJ1yLNLuALfvSkdjRkKm/ai-agent-connect
- **Tags:** floor-plans, spatial-data, architectural-design, estimation, room-scanning, project-oversight

## Description

If you spend half your day digging through floor plans and spreadsheets to find a specific room's area or a material cost, this Connector changes that. It connects your Magicplan workspace to your AI agent, letting you treat your architectural data like a searchable knowledge base. Instead of hunting for a project folder and then squinting at a plan, you can just ask your agent to pull the volume of a specific room or give you a breakdown of the labor costs for a renovation. It handles the heavy lifting of navigating the data, so you get straight answers on spatial measurements and financial estimates. Because Vinkius hosts this Connector, you can plug it into your existing workflow and start querying your projects immediately. It's about moving from manual data entry to just asking for the numbers you need to keep the project moving.

## Tools

### get_plan_measurements
Get numeric measurements like area and perimeter for a plan. It provides the exact numbers you need for calculations.

### list_magicplan_projects
See a list of all floor plan projects in your workspace. This is the first step to finding your active work.

### list_workspace_users
See all the users who have access to your Magicplan workspace. Use this to manage your team's permissions.

### get_workspace_info
Get the configuration settings for your current workspace. This helps you verify your account setup.

### list_project_estimates
See all the financial estimates associated with a project. This allows you to audit multiple costs at once.

### list_available_forms
See all data collection forms and checklists available in your workspace. This helps you find specific survey data quickly.

### get_estimate_details
Get a full financial breakdown for a specific project estimate. It shows the split between labor and materials.

### get_project_floor_plan
Pull all spatial data for a project, including floors and rooms. Use this to get a complete view of the layout.

### get_project_details
Retrieve metadata and status updates for a specific architectural project. This keeps you informed on project progress.

### get_plan_form_data
Get the specific forms attached to a particular floor plan. This connects your survey data to your designs.

## Prompt Examples

**Prompt:** 
```
List all the projects I have in my Magicplan workspace.
```

**Response:** 
```
I've retrieved your projects. You have 3 active projects:

| Project Name | ID | Status |
| :--- | :--- | :--- |
| Beach House Renovation | 123 | Active |
| Downtown Office | 456 | In Progress |
| Modern Loft | 789 | Planning |
```

**Prompt:** 
```
What's the total area and perimeter for the main lobby in project 456?
```

**Response:** 
```
I've pulled the measurements for the lobby in Project 456:

* **Total Area:** 250.5 sqm
* **Perimeter:** 84.2 m
* **Volume:** 1,200.0 m³

Let me know if you need the dimensions for any other rooms.
```

**Prompt:** 
```
Give me a breakdown of the labor and material costs for estimate est-987.
```

**Response:** 
```
Here is the financial breakdown for estimate **est-987**:

* **Total Cost:** $5,450.00
* **Labor:** $2,100.00
* **Materials:** $3,350.00
* **Taxes:** $0.00

There are 12 individual line items included in this total.
```

## Capabilities

### Pull floor plan spatial data
Get details on rooms, floors, and object placements instantly.

### Extract numeric measurements
Get area, perimeter, and volume stats for any specific room or plan.

### Retrieve financial breakdowns
Access itemized lists for labor, materials, and taxes.

### Query project metadata
Get status updates and high-level project details in one go.

### Manage workspace access
List and organize collaborators across your architectural teams.

### Fetch inspection forms
Pull survey data and checklists directly from your plans.

## Use Cases

### Calculating total area for a new office layout
An architect needs to know the total area of all rooms in a new office layout. They ask the agent to use `get_plan_measurements` for the project and get a summary list.

### Auditing labor costs against a project budget
A manager needs to see if the current labor costs are over budget. They ask the agent to pull the breakdown using `get_estimate_details`.

### Retrieving site inspection checklists
A surveyor wants to see all the inspection forms for a specific site. They ask the agent to use `list_available_forms` and `get_plan_form_data`.

### Getting a high-level overview of active projects
A developer wants to see a list of all active projects. They ask the agent to use `list_magicplan_projects` to get a high-level overview.

## Benefits

- Stop manual data entry by using `get_plan_measurements` to pull area and volume stats directly into your reports.
- Get instant access to costs with `get_estimate_details`, which pulls labor and material breakdowns without opening the Magicplan app.
- Keep projects on track by using `get_project_details` to check status updates and metadata through your AI client.
- Pull survey data quickly with `get_plan_form_data` to see exactly what's on the ground for specific plans.
- Manage your team better by using `list_workspace_users` to see who has access to your architectural data.

## How It Works

The bottom line is you get a natural language interface for your entire architectural and financial project data.

1. Subscribe to the Magicplan MCP on Vinkius.
2. Provide your Magicplan Customer ID and API Key in your client settings.
3. Ask your agent to list projects or pull measurements to start working.

## Frequently Asked Questions

**What can I do with the Magicplan MCP?**
You can use your AI agent to query floor plans, pull room measurements, and get financial estimates from your Magicplan workspace using natural language.

**How do I get floor plan measurements using this Connector?**
Just ask your agent for the area, perimeter, or volume of a specific plan or room. It will pull the exact numeric data from your Magicplan project.

**Can I see financial estimates with the Magicplan MCP?**
Yes, you can ask for a full breakdown of labor, materials, and taxes for any estimate in your workspace to audit costs quickly.

**Who should use the Magicplan MCP for their projects?**
It's designed for architects, construction managers, and real estate professionals who need to access spatial and financial data without manual data entry.

**Does the Magicplan MCP work with my current AI client?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf, allowing you to stay in your preferred workspace.

**How do I get my project data into my AI agent?**
By subscribing to this Connector on Vinkius and providing your Magicplan Customer ID and API Key, your agent will gain the ability to read your project data.

**How do I get my Customer ID and API Key?**
Log in to the magicplan Cloud dashboard as an admin, navigate to Workspace Settings > API to generate your credentials.

**Can I see the measurements of a specific room?**
Yes, the `get_plan_measurements` tool returns numeric data for the entire plan, individual floors, and every room within those floors.

**What is included in the financial estimate details?**
The `get_estimate_details` tool retrieves customer contact info, financial totals (labor, material, tax), and a full list of itemized positions/tasks.