How to Use the Aconex MCP in OpenAI Agents SDK

Q: Can the OpenAI Agents SDK handle Aconex user permissions?

Yes, but you need the right role. The agent uses createuser and updateuserstatus which require Organization Administrator permissions.

Bring your Aconex project data into the OpenAI Agents SDK for automated user management and project tracking.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Aconex MCP to OpenAI Agents SDK

Create your Vinkius account to connect Aconex to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Aconex with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate project user invites

Stop manual data entry for project access. Use `invite_user_to_project` and `create_user` to bring new contractors into the environment instantly. Your agent handles the heavy lifting while you keep control. It maps users correctly so no one gets the wrong project permissions.

Search directories with OpenAI Agents SDK

Query your global and project-specific contacts without leaving the terminal. `search_global_directory` and `search_project_directory` pull real-time data directly from the source. Your agent parses these results to find the right person. It saves you from digging through site records manually.

Manage projects with MCP Server tools

Get a clear view of your active work. Call `list_projects` to see what you have access to, or use `copy_project` to replicate structures for new sites. This MCP Server provides the hooks your agent needs. It turns raw API data into actionable project updates.

Setup guide

Set up Aconex MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Aconex tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Aconex tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Aconex tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Aconex Agent",
            instructions="You have access to Aconex tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Aconex. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Aconex now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Aconex MCP in OpenAI Agents SDK

You initialize the MCPServerStreamableHttp class with your endpoint. Pass that into your agent constructor to let the SDK discover all 13 available tools.

Yes, but you need the right role. The agent uses `create_user` and `update_user_status` which require Organization Administrator permissions.

Vinkius handles the connection via a secure endpoint token. The agent only interacts with the tools you explicitly allow it to call.

The agent receives a clear error from the server. You can catch these in your trace logs to see exactly where the process stopped.

It touches names and email addresses when you run directory searches. The connection is ephemeral and strictly scoped to the tools provided.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.