Which integrations are available for this server?

Exposes Autodesk Platform Services (APS) as tools, enabling AI assistants to interact with the APS Data Management API for listing hubs and obtaining access tokens.

How do I use ACC.MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ACC.MCP List all my Autodesk hubs" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ACC.MCP – MCP service for Autodesk Platform Services

MCP (Model Context Protocol) server that exposes Autodesk Platform Services (APS) as tools for AI assistants (e.g. Cursor).

Requirements

Node.js 18+
APS application with Client ID and Client Secret (2-legged OAuth)

Setup

Install dependencies
```
npm install
```
Configure credentials
Copy .env.example to .env and set your APS app credentials:
```
cp .env.example .env
# Edit .env: set APS_CLIENT_ID and APS_CLIENT_SECRET
```
Build
```
npm run build
```
Pack (optional) If you want to use it on Claude Desktop, you can pack the MCP to a .mcpb
```
npm run pack
```

Running the MCP service

The server uses stdio transport: a client (e.g. Cursor) spawns this process and talks to it via stdin/stdout.

Run directly: npm start or node dist/index.js
With env file: use dotenv or your shell to load .env before starting

Cursor configuration

Add this MCP server in Cursor (e.g. Settings → MCP or .cursor/mcp.json):

{
  "mcpServers": {
    "acc-mcp": {
      "command": "node",
      "args": ["c:/repositories/00-Research/ACC.MCP/dist/index.js"],
      "env": {
        "APS_CLIENT_ID": "your_client_id",
        "APS_CLIENT_SECRET": "your_client_secret",
        "APS_SCOPE": "data:read"
      }
    }
  }
}

Use the path to dist/index.js that matches your machine. You can also run via npx or a wrapper script that loads .env and then runs node dist/index.js.

Tools

Simplified tools (recommended)

These return compact, pre-processed summaries (~95 % smaller than raw API responses) and include parameter validation with helpful error messages.

Tool	Description
`aps_list_hubs`	List all ACC / BIM 360 hubs (accounts) — returns name, id, type, region.
`aps_list_projects`	List projects in a hub — returns name, id, platform, last modified.
`aps_get_top_folders`	Get root folders for a project (Project Files, Plans, Shared, …).
`aps_get_folder_contents`	Summarised folder listing with file-type breakdown, sizes, version info. Supports filtering by extension and hiding hidden items.
`aps_get_item_details`	Metadata for a single file: name, type, size, version number, dates.
`aps_get_folder_tree`	Recursive folder-tree with file counts per folder (configurable depth).
`aps_docs`	APS quick-reference: common ID formats, browsing workflow, API paths, file extensions, error troubleshooting.

Power-user tools

Tool	Description
`aps_get_token`	Verify credentials / obtain a 2-legged access token. All other tools handle tokens automatically.
`aps_dm_request`	Call any Data Management API endpoint from the APS Data Management spec: `project/v1` (hubs, projects, topFolders) and `data/v1` (folders, contents, items, versions, downloads, jobs, storage, commands). Returns the full JSON:API response. Parameters: `method` (GET, POST, PATCH, DELETE), `path`, optional `query` and `body`.

Typical workflow

aps_list_hubs                                    → pick a hub
aps_list_projects(hub_id)                        → pick a project
aps_get_top_folders(hub_id, project_id)          → see root folders
aps_get_folder_contents(project_id, folder_id)   → browse files
aps_get_item_details(project_id, item_id)        → file metadata

For write/create operations (e.g. create folder, create item, execute command) use aps_dm_request and set APS_SCOPE to include data:write or data:create as required by the endpoint.

MCP Bundle (.mcpb)

This project can be packed as an MCP Bundle for one-click install in Claude Desktop and other MCPB-compatible apps.

Create the bundle
```
npm run pack
```
This builds the server, prepares a bundle directory (manifest + server + production dependencies), zips it to acc-mcp.mcpb, then removes the temp directory. On Windows the script uses PowerShell Compress-Archive; on macOS/Linux it uses zip -r.
Install the bundle
Open acc-mcp.mcpb in Claude for macOS or Windows (or any app that supports MCPB). You’ll be prompted for APS Client ID and APS Client Secret; the app will pass them to the server as environment variables.
For a step-by-step walkthrough with screenshots, see docs/claude-desktop-installation.md.