# Aconex MCP

> Aconex manages construction and engineering projects by giving your AI agent direct access to project data. You can list all active projects, search global directories for specific users or organizations, copy entire project templates, and invite team members directly from any MCP-compatible client.

## Overview
- **Category:** collaboration
- **Price:** Free
- **Tags:** construction-management, aconex, oracle-aconex, project-directory, engineering

## Description

Your AI agent now acts as a specialized project coordinator for Aconex, putting complex construction and engineering management workflows right into natural conversation. You can tell your agent to list every project you have access to or find the logo associated with that site. Need to onboard new workers? Your agent handles inviting users directly to active projects. If you're starting a similar job, you don't need to build it from scratch; you just ask your AI client to copy an existing project template with all its details intact. Beyond basic setup, you can search the Global Directory or specific site directories to locate any user or organization quickly. This level of integrated control is what Vinkius brings to the catalog, ensuring your agent has deep, reliable access across your entire portfolio.

## Tools

### copy_project
Creates a brand-new copy of an existing Aconex project template.

### create_mailing_group
Sets up a dedicated group email list within a specific project.

### create_user
Adds a brand-new user account to your organization, requiring administrator permissions.

### delete_mailing_group
Removes an existing mailing group from a project's communication list.

### get_me
Shows your own user profile information within Aconex.

### get_project_logo
Retrieves the official logo image for a specified project.

### get_register_schema
Fetches the detailed document register structure used by a particular project.

### invite_user_to_project
Sends an invitation to a user, granting them access to join a specific project.

### list_organization_users
Lists all users belonging to your organization (requires administrator role).

### list_projects
Pulls a list of all projects associated with your account.

### search_global_directory
Searches across the entire global directory for users by name or criteria.

### search_project_directory
Narrows down user searches to only those within a specific project's team.

### update_user_status
Requires Organization Administrator permissions.

Enable or disable existing users

## Prompt Examples

**Prompt:** 
```
List all my active projects in Aconex.
```

**Response:** 
```
I have retrieved your active projects. You have access to: 'Metropolitan Highway Expansion' (ID: 849201) and 'Downtown Commercial Tower' (ID: 302948). Would you like to inspect the details of either project?
```

**Prompt:** 
```
Search the global directory for users with the family name 'Smith' in the organization 'BuildCorp'.
```

**Response:** 
```
Searching the Global Directory... I found 2 matching users:
1. John Smith (john.smith@buildcorp.com)
2. Sarah Smith (sarah.smith@buildcorp.com)
Would you like to invite either of them to a project?
```

**Prompt:** 
```
Invite user 'usr-92018' to project 849201.
```

**Response:** 
```
I've sent an invitation to user 'usr-92018' for project 849201 ('Metropolitan Highway Expansion'). They will receive a notification to join the project directory.
```

## Capabilities

### List all projects
Retrieves a list of every project you have visibility into.

### Find users and groups
Searches both the Global Directory and specific project directories for people, teams, or organizations.

### Duplicate project templates
Creates a new project that copies the configurations—like name and code—from an existing template.

### Manage team access
Invites specific users to join projects or creates necessary mailing groups for communication.

## Use Cases

### Launching a new site phase
A Project Manager needs to start 'Site Alpha,' which is identical to last year's 'Site Beta.' Instead of manually recreating the template, they ask their agent to `copy_project` from Site Beta. The resulting project is instantly configured with all necessary details.

### Finding a specific contractor
An Operations Lead needs contact info for 'Garcia Construction' on an unrelated project. They use the agent to `search_global_directory` by organization, immediately getting the right contacts without knowing which project directory they belong in.

### Adding a new team member
A Document Controller finds a user's ID via `list_organization_users`. They then tell the agent to `invite_user_to_project` for the specific site, making sure the user is part of the right team instantly.

### Starting communication flow
A Project Manager needs a group chat for all sub-contractors. They ask their agent to `create_mailing_group` within the project context, setting up immediate communication without manual list management.

## Benefits

- Start new jobs faster. Instead of manually rebuilding a template, you can ask your agent to copy an existing project using the `copy_project` tool, preserving all configurations like name and type.
- Never get lost in directories again. You can search people globally or locally with tools like `search_global_directory` or `search_project_directory`, getting immediate results without clicking multiple tabs.
- Streamline team onboarding. When a new phase starts, simply tell your agent to invite users using `invite_user_to_project`. They handle the invitation process instantly.
- Maintain project consistency. Quickly get necessary data, like checking logos with `get_project_logo` or retrieving complex structures via `get_register_schema`, without leaving your main workspace.
- Automate communication setup. You can set up entire communication channels by asking to create a mailing group using `create_mailing_group`, keeping stakeholders organized from day one.

## How It Works

The bottom line is that your AI client handles all the backend API calls so you can manage complex project logistics using simple chat commands.

1. First, subscribe your AI client and provide the required Aconex Hostname and authorization credentials.
2. Next, you instruct your agent using plain language to perform a project management task, like listing projects or finding a user.
3. Your agent executes the necessary calls against your Aconex account and returns the requested structured data directly to your conversation.

## Frequently Asked Questions

**How do I list all my projects in Aconex using the Aconex MCP?**
You ask your agent to `list_projects`. It pulls a comprehensive list of every project you have access to, giving you an immediate overview without needing to log into the main portal.

**Can I find users in my organization using Aconex MCP?**
Yes. You can use `search_global_directory` for broad searches or `list_organization_users` if you are an administrator and just need a full roster.

**What is the best way to start a new project with Aconex MCP?**
The most efficient method is using `copy_project`. This tool replicates an existing, working template, saving you from having to manually enter all the initial configuration details.

**Does Aconex MCP help me manage team roles?**
It helps with access. You can use `invite_user_to_project` to grant specific users access, or run `create_mailing_group` to set up necessary communication channels.

**Do I need administrator rights for Aconex MCP?**
Some tools, like creating a user (`create_user`) or listing all organization users (`list_organization_users`), require specific Organizational Administrator permissions. Your agent will notify you if it lacks the necessary access.

**How do I list all the active construction projects I have access to?**
You can ask your AI agent to run the `list_projects` tool. It will query Aconex and return a complete list of projects associated with your authenticated account.

**Can I search for users and organizations outside of my current project directory?**
Yes! Use the `search_global_directory` tool to search across the entire Aconex Global Directory using parameters like organization name, given name, family name, or email.

**Is it possible to duplicate or copy an existing project template?**
Yes, you can use the `copy_project` tool. Provide the source `project_id` along with the new project's name, short name, code, type, and start date to create a copy within your organization.