# Sparx Systems Enterprise Architect

> Enterprise Architect is a desktop modeling, design and management platform for enterprise
> architecture, software engineering and systems engineering. Its programmatic surface is unusual
> for this catalog and worth stating plainly up front: there is no public, callable, vendor-hosted
> API. Every surface is either in-process on a licensed Windows machine (COM Automation Interface,
> Add-In Framework, scripting engine, MCP server) or served by software the customer installs on
> their own infrastructure (Pro Cloud Server OSLC RESTful API). There is no OpenAPI, no GraphQL, no
> webhook or event surface, and no agent card. There IS a first-party MCP server, and it is
> STDIO-only by deliberate design.

Generated by API Evangelist from apis.yml and the artifacts in this repository, 2026-08-29.
sparxsystems.com serves no /llms.txt (HTTP 404); the Sparx Systems North America regional site does,
and it is saved verbatim alongside this file as sparx-enterprise-architect-north-america-llms.txt.

## APIs

- [Pro Cloud Server OSLC RESTful API](https://sparxsystems.com/enterprise_architect_user_guide/17.0/pcs_overview.htm): OSLC Architecture Management v2.0 over HTTP, RDF/XML in and out. Base URL is the customer's own Pro Cloud Server: `<protocol>://<server>/<model_name>/oslc/`. Requires a paid Pro Cloud Server licence.
- [Enterprise Architect Automation Interface](https://sparxsystems.com/enterprise_architect_user_guide/17.0/automation.htm): COM object model (Repository, Package, Element, Diagram, Connector) for in-process automation from .NET, Java, VB and other COM-capable languages.
- [Enterprise Architect Add-In Framework](https://sparxsystems.com/enterprise_architect_user_guide/17.0/add-ins_2.htm): Build add-ins that respond to application events, add menu items and integrate with external systems.
- [Enterprise Architect Scripting](https://sparxsystems.com/enterprise_architect_user_guide/17.0/scripting.htm): Built-in JavaScript, JScript and VBScript engine with full access to the automation interface.
- [MCP Server for Enterprise Architect](https://www.sparxsystems.jp/en/MCP/): First-party Model Context Protocol server, v2.8.11 (13 Aug 2026), 38 tools, free. STDIO transport only.

## OSLC endpoints

- `POST /{model_name}/oslc/am/login/` — obtain the user authentication token (returned as `ss:useridentifier`)
- `GET  /{model_name}/oslc/am/logout/?useridentifier={token}` — invalidate the token
- `GET  /{model_name}/oslc/am/sp/` — Service Provider Resource; the discovery document naming creation, query and resource-shape URLs
- `POST /{model_name}/oslc/cf/` — Creation Factory; POST RDF/XML to create a resource
- `GET  /{model_name}/oslc/qc/` — Query Capability; supports oslc.where, oslc.select, oslc.properties, oslc.prefix
- `GET  /{model_name}/oslc/re/{GUID}/` — a single resource by GUID

## What an agent needs to know before writing

- **No idempotency.** No idempotency key or dedupe header exists. A retried `POST /oslc/cf/` creates a second element.
- **OSLC writes are not audited.** The provider states changes made through OSLC are not recorded even when Enterprise Architect auditing is enabled.
- **OSLC has no undo.** No cancel, restore or soft-delete path is published for the OSLC surface.
- **MCP writes DO have an undo.** Capture a package baseline with `create_baseline` before acting and restore it with `apply_baseline`. No retention window is stated.
- **MCP edit and delete are off by default.** `-enableEdit` and `-enableDelete` must be passed to MCP3.exe. The provider warns that in their own testing an instruction to delete tagged values deleted an entire package.
- **Element type strings must be exact.** They must match the Automation Interface type names; the MCP server ships prompts (UML, SysML 1.5, BPMN 2.0) that supply them.
- **No rate limits are published**, and none apply — the server is the customer's own.

## Artifacts

- [MCP server manifest](mcp/sparx-enterprise-architect-mcp.yml)
- [Authentication profile](authentication/sparx-enterprise-architect-authentication.yml)
- [API conventions and reversibility](conventions/sparx-enterprise-architect-conventions.yml)
- [Error catalog](errors/sparx-enterprise-architect-problem-types.yml)
- [Data model](data-model/sparx-enterprise-architect-data-model.yml)
- [Standards conformance](conformance/sparx-enterprise-architect-conformance.yml)
- [Lifecycle](lifecycle/sparx-enterprise-architect-lifecycle.yml)
- [Changelog](changelog/sparx-enterprise-architect-changelog.yml)
- [Packages](packages/sparx-enterprise-architect-packages.yml)
- [Plans and pricing](plans/sparx-enterprise-architect-plans-pricing.yml)
- [Rate limits](rate-limits/sparx-enterprise-architect-rate-limits.yml)
- [Domain security](security/sparx-enterprise-architect-domain-security.yml)
- [Well-known probe](well-known/sparx-enterprise-architect-well-known.yml)
- [Agent skills](skills/_index.yml)

## Docs

- [Enterprise Architect User Guide 17.0](https://sparxsystems.com/enterprise_architect_user_guide/17.0/)
- [Automation Interface reference](https://sparxsystems.com/enterprise_architect_user_guide/17.0/automation_and_scripting/automation_interface.htm)
- [Pro Cloud Server overview](https://www.sparxsystems.us/pro-cloud-server/)
- [Getting started](https://sparxsystems.com/enterprise_architect_user_guide/17.0/getting_started.htm)
- [Pricing](https://www.sparxsystems.us/sparx-license-pricing/enterprise-architect/)
- [Support](https://sparxsystems.com/support/)
- [Community forum](https://sparxsystems.com/forums/smf/)

## Standards

- OSLC Architecture Management v2.0, RDF/XML, W3C Linked Data, Dublin Core 1.1, FOAF
- OpenID Connect, OAuth 2.0 authorization code, NTLM
- Model Context Protocol (STDIO)
- UML 2.5, ArchiMate 3.2, BPMN 2.0, SysML, UAF 1.2, XMI, TOGAF, NAF v4, BIAN, TM Forum ODA, C4