# Aps Mcp Server Gen

> >

- **Type:** Skill
- **Install:** `agentstack add skill-autodesk-platform-services-skills-aps-mcp-server-gen`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [autodesk-platform-services](https://agentstack.voostack.com/s/autodesk-platform-services)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [autodesk-platform-services](https://github.com/autodesk-platform-services)
- **Source:** https://github.com/autodesk-platform-services/skills/tree/main/skills/aps-mcp-server-gen

## Install

```sh
agentstack add skill-autodesk-platform-services-skills-aps-mcp-server-gen
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# APS MCP Server Generator

This skill creates a fully working MCP server project that connects to
Autodesk Platform Services (APS). Follow the steps below exactly.

## Step 1 — Gather Requirements

Ask the user **all three questions at once** if they have not already answered:

1. **Language** — Node.js/TypeScript, .NET/C#, or Python?
2. **Transport** — Local (STDIO, for Claude Desktop or similar) or Cloud (Streamable HTTP, for web deployment)?
3. **Authentication** — Which APS auth pattern?
   - **2-legged OAuth** — app accesses its own resources; no user sign-in (note: legacy, but still supported)
   - **Secure Service Accounts (SSA)** — automated server-to-server; acts on behalf of a real user without interactive login
   - **3-legged OAuth** — user signs in via browser; server acts on their behalf

If the user's request already makes one of the choices clear (e.g., "Python FastMCP server"), skip that question.

## Step 2 — Load Reference Docs

Before writing any files, load the appropriate references:

- **Node.js** → read [`references/nodejs.md`](references/nodejs.md)
- **.NET** → read [`references/dotnet.md`](references/dotnet.md)
- **Python** → read [`references/python.md`](references/python.md)
- **2-legged OAuth** → read [`references/auth-2lo.md`](references/auth-2lo.md)
- **Secure Service Accounts** → read [`references/auth-ssa.md`](references/auth-ssa.md)
- **3-legged OAuth** → read [`references/auth-3lo.md`](references/auth-3lo.md)
- **STDIO** → read [`references/transport-stdio.md`](references/transport-stdio.md)
- **Streamable HTTP** → read [`references/transport-http.md`](references/transport-http.md)
- **Always** → read [`references/testing.md`](references/testing.md)

## Step 3 — Confirm Output Directory

Ask or confirm where to create the project (default: `./aps-mcp-server` in the current directory).

## Step 4 — Scaffold the Project

Create every file needed for a working project. Do **not** leave placeholder TODOs — generate complete, runnable code. Use the patterns from the reference files exactly.

### Files to create (all languages)

| File | Purpose |
|------|---------|
| `.env.example` | All required env vars with placeholder values and comments |
| `README.md` | Setup, run, MCP client config, and test instructions |
| Main server file | Language-specific entry point |
| Tool file(s) | At least one example APS tool (e.g., list OSS buckets) |
| Auth helper | Token acquisition logic for the chosen auth type |
| Test file(s) | Unit tests with mocked APS calls (see `testing.md`) |

### Language-specific additional files

- **Node.js**: `package.json`, `tsconfig.json` (if TypeScript), `vitest` dev dependency
- **.NET**: `.csproj`, `appsettings.json`, `*.Tests` project with xUnit + NSubstitute
- **Python**: `pyproject.toml` (uv-managed), `pytest` + `pytest-asyncio` dev dependencies

## Step 5 — Post-Scaffold Instructions

After creating files, tell the user:

1. How to install dependencies (including test dependencies)
2. How to fill in `.env` (which APS portal pages to visit for each credential)
3. How to run the unit tests (no credentials required)
4. How to run the server
5. How to connect to it from an MCP client (Claude Desktop config or Inspector URL)
6. How to run an interactive smoke test with MCP Inspector

## Key Rules

- **Never implement token passthrough.** The MCP server must authenticate with APS itself — it must never accept APS tokens from the MCP client and forward them.
- **Always cache tokens.** Check expiry before every APS call; refresh proactively (≥60 s before expiry).
- **STDIO ↔ Stateless HTTP distinction.** STDIO servers are inherently single-session. Streamable HTTP servers should default to stateless (no session ID) unless 3-legged OAuth is chosen, which requires stateful sessions to track per-user tokens.
- **Tool descriptions matter.** Write clear docstrings/descriptions for every tool — the LLM uses them to decide when to call each tool.
- **Return both `content` and `structuredContent`** in Node.js tools when the data could be consumed programmatically (e.g., by a UI component). Python FastMCP infers structured output automatically from return types.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [autodesk-platform-services](https://github.com/autodesk-platform-services)
- **Source:** [autodesk-platform-services/skills](https://github.com/autodesk-platform-services/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-autodesk-platform-services-skills-aps-mcp-server-gen
- Seller: https://agentstack.voostack.com/s/autodesk-platform-services
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.