Pavel on AsyncAPI
AsyncAPI plugin for JetBrains IDEs

The AsyncAPI editor for IntelliJ IDEA and every JetBrains IDE

Write, validate and preview AsyncAPI 2.x and 3.x documents. Generate them from Spring code or a live Kafka, Pulsar, SNS or SQS system, and see where the document, the code and the broker disagree. All without leaving the IDE.

downloads
63k+
from 7 ratings
4.1 ★
released Nov 3, 2026
5.1.0
IntelliJ IDEA with an AsyncAPI 3.0 document on the left and its rendered documentation preview on the right
What you can do

From the first document to keeping it true

One plugin for the whole life of an AsyncAPI document: writing it, generating it from what exists, and checking it still matches.

Free

Write and validate AsyncAPI documents

Open any AsyncAPI file and the IDE knows the specification: errors as you type, completion for every field, and a rendered preview next to the source.

  • Validation against up-to-date AsyncAPI JSON Schemas for 2.0.0 to 3.1.0, with quick fixes
  • Completion for channels, operations, messages, bindings, security schemes and enum values
  • Preview in a split pane or in the browser, with every $ref resolved
  • Completion and Go to Declaration across files and remote URLs, through JSON Pointers
  • New documents from templates, in YAML or JSON
Free + Pro

Generate AsyncAPI from Spring code

The AsyncAPI: Spring tool window finds every listener and sender in a Spring project, shows how they connect, and exports an AsyncAPI document per environment.

  • Listeners: @KafkaListener, @RabbitListener, @PulsarListener, @SqsListener, @JmsListener, SNS and STOMP mappings
  • Senders: KafkaTemplate, RabbitTemplate, JmsTemplate, PulsarTemplate, SqsTemplate, SnsTemplate, SimpMessagingTemplate
  • A topology of producers and consumers per channel, across modules and protocols
  • Export for Apache Kafka, Apache Pulsar, Amazon SQS, Amazon SNS and JMS, with bindings read from the code
  • Free inspections for listener mistakes, such as two @KafkaListener methods sharing a groupId
The AsyncAPI: Spring tool window listing Kafka listeners and the AsyncAPI document exported from them
Pro

Document a live Kafka, Pulsar, SNS or SQS system

Point the plugin at a cluster or an AWS account and get an AsyncAPI document of its topics and queues. No source code needed, so it works in every JetBrains IDE.

  • Broker Connections for Kafka (including Confluent Cloud and Schema Registry), Pulsar 4.0 and 5.0, and AWS accounts
  • Secrets kept in the IDE password safe, never in project files
  • AsyncAPI: Preview shows what a connection holds: topics, partitions, consumer groups, ACLs, queues and their policies
  • Read-only, and only when you ask. What the user may not see is reported, not hidden
Tools → Export AsyncAPI from a Broker… → prod-kafka
servers:
  prod-kafka:
    host: kafka-1.prod:9092
    protocol: kafka
channels:
  orders.created:
    address: orders.created
    bindings:
      kafka:
        partitions: 12
        replicas: 3
        topicConfiguration:
          retention.ms: 604800000
Pro

Catch drift between the document, the code and the broker

The AsyncAPI: Diff tool window compares what you declared with what runs, one coloured row per channel, and says plainly what it could not check.

  • Document against a connection, connection against connection (staging against production)
  • Source code against a connection, and document against source code
  • Consumer groups and subscriptions checked against the ones actually reading
  • Filters to leave only what needs attention
AsyncAPI: Diff · orders.yaml ↔ prod-kafka
  • orders.createdmatches
  • payments.settledpartitions: 12 declared, 6 on prod-kafka
  • orders.cancelledconsumer group billing is not reading it
  • audit.eventsno schema registry: payload not checked
Free + Pro

Give your AI agent real answers about messaging

Ten tools in the MCP server bundled with your IDE let any MCP client ask what the plugin knows: resolved topic names, payload types and consumer groups that a text search cannot find.

  • Finding and validating AsyncAPI documents is free
  • Code analysis, broker connections and comparisons are Pro, and a Pro tool says what it needs
  • One command installs an agent skill that explains which tool answers which question
Your agent, with the plugin's MCP tools

Which consumer groups read orders.created on prod-kafka, and which code handles it?

asyncapi_topology asyncapi_endpoints

Two groups read it: billing and analytics. It is handled by OrderEvents.onCreated in the orders-service module.

Who it is for

What each role gets

  • Spring developer

    Stop writing the AsyncAPI document by hand, and stop it going stale.

    • Export from Spring Messaging code
    • Listener inspections while you type
    • Topology of who sends and who receives
  • API designer or architect

    Design contracts that are valid, consistent and easy to review.

    • Validation, completion and preview
    • Reusable components as their own files
    • Spectral and Redocly linting
  • Platform or data engineer

    Know what is really on the cluster, and document it.

    • Export from a live cluster or AWS account
    • Connection preview: topics, groups, ACLs, queues
    • Staging against production diff
  • QA and governance

    Check that what was promised is what runs.

    • Document, code and broker diff
    • Honest grey where nothing could be checked
    • Lint rules in the IDE, the same as in CI
  • Developer working with AI agents

    Let the agent answer messaging questions from facts, not guesses.

    • Ten MCP tools in the IDE
    • Agent skill installed in one step
    • The same broker tools as Kurkik in the terminal
AI agents

Ask your agent, the plugin answers

The plugin adds ten tools to the MCP server bundled with JetBrains IDEs. Your agent gets facts the plugin already worked out: topics behind Spring properties, payload types, consumer groups, what a broker holds right now.

  1. Enable the server in Settings → Tools → MCP Server and copy its configuration into your agent.
  2. Run Tools → Install AsyncAPI Agent Skill. It writes .claude/skills/asyncapi/SKILL.md, which tells the agent which tool answers which question.

Finding and validating documents is free. asyncapi_connections and asyncapi_topology are the same tools Kurkik serves with kurkik mcp in a terminal.

Ask your agentTool
“Which messaging APIs does this service expose? Does the orders module use Kafka?”asyncapi_inventory
“Find every handler and producer for the orders topic.”asyncapi_endpoints
“Check this project for Kafka problems, worst first.”asyncapi_diagnostics
“What happens when a message arrives on orders, and where does it end up?”asyncapi_flow
“Generate an AsyncAPI document for the orders module as it runs in prod.”asyncapi_export
“Does asyncapi/orders.yaml still match the prod-pulsar connection?”asyncapi_compare
“Which broker connections can you use?”asyncapi_connections
“What topics does prod-kafka have, and which consumer groups read them?”asyncapi_topology
“Which AsyncAPI documents exist here, and what uses components/order.yaml?”asyncapi_documents
“Validate this AsyncAPI document and tell me what is broken.”asyncapi_validate
Free and Pro

A free AsyncAPI editor, and Pro for code, brokers and drift

Everything you need to write and check AsyncAPI documents is free, with no account. Pro starts with a 30-day trial, and a licence keeps solo development sustainable. Why freemium.

Free No account

  • Create documents from scratch or a template
  • Validate and complete as you type
  • Preview in the IDE and in the browser
  • Explore a document as a tree (read-only)
  • Reference completion and JSON Pointer navigation, local and remote
  • One approved remote host; denying hosts is unlimited
  • Spring messaging inspections for Kafka, Pulsar, SQS, SNS and JMS
  • MCP: find and validate AsyncAPI documents
Install

Pro 30-day trial

Everything in Free, plus:

  • Components as their own files: create, validate, complete, preview
  • Edit documents and components through a form
  • Project Overview of every document and component
  • AsyncAPI: Spring: listeners, senders, topology, export
  • AsyncAPI: Brokers: export from a live cluster or AWS account
  • AsyncAPI: Preview: what a connection holds
  • AsyncAPI: Diff: documents, code and live brokers
  • Spectral and Redocly linting
  • More than one remote host, and an HTTP proxy
  • MCP tools that read code or brokers, or compare
Start the trial

Every feature, Free and Pro

Supported IDEs, versions and protocols

JetBrains IDEs
IntelliJ IDEA, WebStorm, PyCharm, GoLand, PhpStorm, Rider, RustRover, CLion, RubyMine, DataSpell, Android Studio. Version 2026.1 or later.
AsyncAPI versions
2.0.0 to 2.6.0, 3.0.0 and 3.1.0, in YAML and JSON
Protocol bindings
Amazon SNS, Amazon SQS, AMQP 0-9-1, AMQP 1.0, Anypoint MQ, Apache Kafka, Apache Pulsar, Google Cloud Pub/Sub, HTTP, IBM MQ, JMS, Mercure, MQTT, MQTT 5, NATS, Redis, Solace, STOMP, WebSockets. See the bindings reference.
Schema formats
AsyncAPI Schema, JSON Schema, OpenAPI 3 Schema, Avro, XML. See multi-format schemas.
Plugin questions

AsyncAPI in IntelliJ IDEA: questions

Is there an AsyncAPI plugin for IntelliJ IDEA?

Yes. The AsyncAPI plugin on JetBrains Marketplace adds validation, completion, preview and reference navigation for AsyncAPI documents to IntelliJ IDEA and the other JetBrains IDEs. Install it from Settings → Plugins → Marketplace by searching for AsyncAPI.

Is the AsyncAPI plugin free?

The editor is free: creating, validating, completing and previewing documents, reference navigation and the Spring messaging inspections. Spring and broker export, connection preview, drift detection, UI editing, linting and the deeper MCP tools are Pro, with a 30-day free trial. Why the plugin is freemium.

Which JetBrains IDEs does it work in?

IntelliJ IDEA, WebStorm, PyCharm, GoLand, PhpStorm, Rider, RustRover, CLion, RubyMine, DataSpell, Android Studio, from version 2026.1. Features that read Java or Kotlin source, such as the Spring tool window, need the Java plugin, which IntelliJ IDEA bundles. Everything else works in every IDE.

Does it support AsyncAPI 3?

Yes. Validation and completion cover AsyncAPI 2.0.0 to 2.6.0, 3.0.0 and 3.1.0, in YAML and JSON. The preview renders 2.6.0, 3.0.0 and 3.1.0.

How do I preview an AsyncAPI document in IntelliJ IDEA?

Open the document: the plugin shows the rendered documentation in a split pane next to the source, or in your browser. Local, file and remote references are resolved first. See reading a document.

Can it generate an AsyncAPI document from Spring Kafka code?

Yes, with Pro. The AsyncAPI: Spring tool window reads @KafkaListener, @KafkaHandler, @SendTo and KafkaTemplate calls, and exports a document per environment with servers from your Spring configuration. It does the same for Pulsar, SQS, SNS and JMS. See how Spring Kafka maps to AsyncAPI.

Can it create an AsyncAPI document from a running Kafka cluster?

Yes, with Pro. Add the cluster under Broker Connections and run Tools → Export AsyncAPI from a Broker…. It works the same for Apache Pulsar and for Amazon SNS and SQS in an AWS account, and it only reads.

How does it work with AI agents?

The plugin adds ten tools to the MCP server bundled with JetBrains IDEs. Enable the server in Settings → Tools → MCP Server, connect your agent, and run Tools → Install AsyncAPI Agent Skill. Document discovery and validation are free.

How is the plugin different from Kurkik?

The plugin works inside the IDE, next to the code. Kurkik is a command-line tool for CI and terminals that documents live brokers and detects drift. They share the same broker preview and MCP tools, so both give the same answers.

About

Built by an AsyncAPI maintainer

I'm Pavel Bodiachevskii, a member of the AsyncAPI Technical Steering Committee and a maintainer in the AsyncAPI ecosystem, including the JAsyncAPI library used by Springwolf, the Quarkus AsyncAPI extension and Specmatic. The tools and docs here come from daily work with the specification, brokers and real event-driven systems.

Like the free docs, JAsyncAPI and the plugin's free core? Sponsor them on GitHub, or tell me how you use them.

From the blog

All posts