.mdx files, so any MDX-aware editor gives you syntax highlighting for free. AgentMark layers on top of that with a JSON Schema for frontmatter (enables model_name autocomplete) and MCP configs that let your editor’s AI query AgentMark docs + traces.
Syntax highlighting
Install an MDX extension — TemplateDX files are recognized as MDX.| Editor | Extension |
|---|---|
| VS Code / Cursor / Windsurf | Search for “MDX” in the extensions panel (unifiedjs.vscode-mdx) — also available via Open VSX for VSCodium, Cursor, and Gitpod. |
| JetBrains IDEs | MDX plugin |
| Zed | Built-in MDX support. |
Frontmatter autocomplete via JSON Schema
Run the AgentMark CLI to generate a JSON Schema for your prompt frontmatter:.agentmark/prompt.schema.json, classifying your configured models into text_config, object_config, image_config, and speech_config blocks with model-name enum autocomplete. Most editors (VS Code, Cursor, JetBrains) will pick up the schema automatically when it’s referenced from your .prompt.mdx frontmatter.
MCP: let your editor AI query AgentMark
When you scaffold an AgentMark project withnpm create agentmark@latest, the scaffolder writes MCP server configs tailored to your editor:
agentmark-docs— lets the editor’s AI query AgentMark documentationagentmark-traces— lets the editor’s AI query your local trace data
| Editor | Config file | Shape |
|---|---|---|
| VS Code | .vscode/mcp.json | { "servers": { ... } } |
| Cursor | .cursor/mcp.json | { "mcpServers": { ... } } |
| Zed | .zed/settings.json | { "context_servers": { ... } } |
| Claude Code | .mcp.json | { "mcpServers": { ... } } — requires "type": "http" on URL servers |
npm create agentmark@latest -- --client <vscode|cursor|zed|claude-code> to regenerate.
Related
Docs MCP
Per-IDE setup for
agentmark-docsTrace MCP server
Local trace debugging via
agentmark-traces