Dev Portal MDC

Get MDC Syntax Guide

Retrieves the complete MDC (Markdown Components) syntax guide including component syntax, props, slots, nesting rules, and best practices. **Call this tool ONCE at the start of your session before using other tools.** After reading, you will understand MDC syntax and can use other tools without calling this again. This is essential prerequisite knowledge for generating valid MDC.

Get AI Agent Workflow Guide for this MDC Server

Retrieves AI agent workflow instructions for interacting with the MDC server. **Call this tool ONCE at the start of your session.** Provides essential guidance on: tool usage patterns (which tools to call and when), metadata verification workflows, syntax validation procedures, design requirements (accessibility, responsiveness, spacing), error prevention strategies, and how to guide users effectively through component composition. This establishes the correct operational framework for helping u

List Components

Lists all available Dev Portal MDC components with basic information (name, description, documentation URL). Use this to discover what components are available. For detailed component information including props and slots, use get_component_metadata. For usage examples, use get_component_examples. Requires MDC syntax knowledge from get_mdc_syntax_guide.

Get Design Tokens

Retrieves globally available dev portal design tokens (CSS custom properties) with their default values, categories, and usage examples. Design tokens provide standardized values for colors, fonts, borders, icons, animations, breakpoints, spacing, shadows, and component-level overrides. **Important**: The values returned are defaults that may be overridden in the Dev Portal for customization. A `null` default_value indicates a component token whose value is inherited at runtime from semantic tok

Get Component Metadata

Retrieves the definitive metadata for a specific Dev Portal MDC component including all available props, slots, default values, and type information. **ALWAYS use this tool to verify props and slots exist before suggesting component usage.** Returns complete component documentation in JSON format. Never invent prop names - always reference this metadata. Requires MDC syntax knowledge from get_mdc_syntax_guide. When utilizing components, always prefer built-in props defined in this metadata for o

Get Component Examples

Retrieves real usage examples for a specific Dev Portal MDC component. Shows multiple patterns and best practices for using the component. Returns MDC syntax examples that demonstrate props, slots, and common use cases. Requires MDC syntax knowledge from get_mdc_syntax_guide.

Validate MDC Syntax

Validates MDC (Markdown Components) content syntax. Checks for proper component definition, slot usage, props formatting, indentation and whitspace issues, and YAML validity. Returns detailed feedback on any syntax errors found. Requires MDC syntax knowledge from get_mdc_syntax_guide.

Format MDC Content

Formats provided MDC content input according to standard MDC formatting rules and returns the formatted content. Use this tool to ensure that your MDC content is properly formatted and adheres to best practices. **You may always also call the `validate_mdc_syntax` tool to identify any major syntax issues.** Input should be raw MDC content as a string, and the output will be the formatted MDC content.

Get MDC Preview URL

Use this tool once you have MDC content you want to visually preview. It renders the MDC as a fully styled Dev Portal page — using the exact same page renderer as the live site — and returns a temporary preview URL. Navigate to it with a browser automation tool to capture screenshots and visually inspect and compare the rendered result in order to iterate and enhance the content. An agent browser automation tool is ideal for navigating to the URL, capturing screenshots, and visually comparing t

Check Authentication

Verifies whether this MCP server ("Dev Portal MDC MCP") received a Konnect Personal Access Token (PAT) on the current request. Performs no network call — it only reports whether the Authorization Bearer token reached the server — so it is a cheap way to fail fast and give the user an actionable fix before wasting effort on a doomed workflow. Call this once at the start of a session, before list_portals or get_mdc_preview_url, whenever you are unsure a PAT is configured.

List Konnect Portals

Lists the Konnect Dev Portals visible to the configured Konnect PAT, so you can determine a `portal_origin` for `get_mdc_preview_url` yourself instead of asking the user. Prefer each portal's `recommended_portal_origin` (its `canonical_domain` if set, otherwise its `default_domain`). By default, probes all known Konnect regions in parallel since a PAT does not encode a region and an organization may have portals in more than one; pass `region` to narrow the search to one region. A region may be