Roadmap

Foundation

Contract-first approach with Gherkin DSL

Core Specification & Stubbing

• Gherkin DSL for API Specification
• Dynamic Stubbing
• Postman collection to Gherkin DSL

Ecosystem Expansion

• Smart Mocks
  
• Java JUnit5 wrapper
  
• OpenAPI, Basic Auth & Token Auth
  
• Backward Compatibility Testing
  
• SOAP / WSDL
  
• Postman Collection import
  
• Node wrapper v1
  
• Proxy Server

Generative & Async Support

• Generative Tests
  
• API Gateway Support
  
• Server Sent Event (SSE) stub – (Pro plan +)
  
• AsyncAPI & JMS mock support – (Pro plan +)

Integration & Maintenance

• Redis Stub – (Pro plan +)
• Node wrapper v2
• Hooks for emulating payment gateways
• Maintenance updates

Broader Language & Protocol Support

• JDBC stub – (Pro plan +)
• Python wrapper
• AsyncAPI Kafka support – (Pro plan +)

Security & Coverage Enhancements

• OpenAPI OAuth Security Scheme
• OpenAPI OpenID Security Scheme
• API Coverage Report

Analytics & Insights

• AsyncAPI 2.6.x – Request Reply pattern support improvements
• VSCode Extension with Generative AI capabilities – beta
• Specmatic Insights – CDD Analytics Dashboard launch
• AsyncAPI Test Interactive HTML report

Platform Expansion

• Specmatic Docker image
• OpenAPI Example as both test and stub
• AsyncAPI (general availability)
• Support for all OpenAPI security schemes
• Externalised test data for contract tests
• Google Pub Sub beta

Cross-Protocol Support

• GraphQL support
• Google Pub Sub (general availability)
• gRPC support
• Improved / descriptive test names
• Jetbrains IDE plugin
• Specmatic config in YAML
• AsyncAPI HTML Report

Intelligent Contracting

• Enhanced OpenAPI Support
  - HTML Report Generation
  - Interactive Examples (generation & validation)
  
• Domain-Aware Contract Intelligence
  - Smart Dictionary
  - Implementation Context-aware Example Generation
  - Intelligent Stub Response Creation
  - Partials for examples - Response Value Substitution from Request
  
• Monitoring & Diagnostics
  - Proxy health & dump endpoints
  - Stub health endpoint
  
• Developer Experience
  - VSCode plugin enhancement to enable agentic workflows.
  
• Sample Implementation Projects
  - GOLang reference implementation
  - C# reference implementaion

Advanced OpenAPI Features

• OpenAPI enhancements
  - Discriminator support
  - Filtering
  - Optional Headers
  
• Overlays Support
  - Extend / customize your OpenAPI specs using OpenAPI overlays
  
• Stateful Stubs

Workflow & Advanced Mocks

• Arazzo support
  - Build Workflows in OpenAPI using Arazzo – Early Access
  
• AsyncAPI 3.x support
  - General availability
  
• Avro Schema Support
  - Early access
  
• Specmatic OpenAPI Commercial Module launch
  
• Interactive Examples GUI
  - Generate and validate examples from OpenAPI spec
  
• Mock Improvements
  - Multi port / base URL stubbing
  

Product Milestones

• Specmatic Studio
  
• API Genie(beta)

Contract Intelligence Across Protocols

• OpenAPI
  - Hooks support in Proxy and Mock
• AsyncAPI
  - Mocking support in Specmatic Studio
• GraphQL
  - Backward compatibility validation
  - Sub-selection support
  - Variables support
  - HTTP headers support
  
• gRPC
  - Backward compatibility validation
• Avro
  - Avro Schema Support
  
• Arazzo support
  - Workflow definition in OpenAPI using Arazzo
  
• Examples
  - Look-ups and substitutions
  -  Dictionaries
  - Partial examples
• Studio
  - Load and Export configuration to Specmatic config
  
• Insights
  - SSO integration (SAML 2.0)
  - Build history tracking
• AI / MCP
  - MCP auto-test generation
  - Specmatic MCP Server

Enterprise-Grade Governance, Reporting & Ecosystem Expansion

• OpenAPI
  - OpenAPI 3.1 support
  - Branch match support in configuration
• AsyncAPI
  - Amazon SNS / SQS protocol support
• GraphQL
  - API coverage report (HTML format)
  
• gRPC
  - API coverage report (HTML format)
  - Enhancements to how external proto files are imported
  - Enhancements to generative tests
• Arazzo
  - OpenAPI and AsyncAPI support in Arazzo specifications
  
• Examples
  - Advanced matchers for OpenAPI and AsyncAPI
  - Transient examples
• Resiliency Testing
  - Native support for 429 and 202 response patterns
• Studio
  - WSDL mocking
  - Intelligent auto-fix for examples
• Insights
  - AsyncAPI support
  - Intelligent backward compatibility analysis with Insights integration
• Reporting
  - CTRF report format support
  
• Platform & Governance
  - Standardised error messages across protocols
  

Expanding Protocol Support

• OpenAPI
  - OpenAPI 3.1.x enhancements
  - Links support
  - Server URL support
  - mTLS for contract tests and mocks
• AsyncAPI
  - Backward compatibility testing
  - ActiveMQ support
  - RabbitMQ support
  - AWS EventBridge support
  - MQTT support
  - WebSocket support
  - Before and after fixtures
• Studio
  - Auto-fix OpenAPI specifications
  - Intelligent live proxy for OpenAPI
  - Enrich existing specifications from live traffic
  - Enhance proxy-generated specifications
  - AsyncAPI testing and mocking
  - Interactive WSDL testing
• Insights
  - Audit logs
  - GraphQL and gRPC support
• Platform & Governance
  - Specmatic Linter
  - Specmatic Lenient Mode
  - Specmatic Config V3
  - Config V2 to V3 migration
  - Run mocks and contract tests together with run-suite

Advancing Testing and API Governance

• AI Assisted Development
  - OpenAPI Spec Extractor skill
  - Fix OpenAPI Spec Skill
  - Debug Specmatic Failure Skill
• OpenAPI
  - Examples for 405 and 415 responses in tests and mocks
  - Improved API coverage and mock-usage reporting
  - Data substitutions across tests and fixtures
  - Template values in external examples
• AsyncAPI
  - Backward compatibility checks
  - Example generation in Studio
• GraphQL & gRPC
  - Backward compatibility checks
• SOAP / WSDL
  - Expanded schema, attribute, and response-header support
• Studio
  - Add out-of-spec responses to an OpenAPI specification from failed tests
  - Generate, validate, and bulk-fix OpenAPI examples
  - Source-linked backward compatibility diagnostics
• Skeptic
  - Enterprise lint command
  - Configurable lint rules, profiles, and HTML reports
• Specademy
  - eLearning module on Spec-First Engineering for self-onboarding
• Platform & Governance
  - Specmatic MCP server for tests, mocks, and backward compatibility checks
  - Operation-level backward compatibility verdicts and CTRF reports

Stateful Mocks and Developer Tools

• AI Assisted Development
  - Generate Specmatic Sample Skill
  
• OpenAPI
  - Stateful mocks that preserve create, update, and delete operations
  - Multipart form-data and file-upload examples in tests and mocks
  - Example generation and fixing via CLI
  - Turn OpenAPI Security Schemes into executable API Security Tests
• AsyncAPI
  - Substitutions and shared state across fixtures and contract tests
  - Expanded schema and example validation
  - Named-server resolution in test and mock configuration
• Arazzo
  - Enterprise test, mock, validate, and suite support
  - Multi-spec execution with combined reports
• SOAP / WSDL
  - Substitution groups, abstract types, and polymorphic extensions
• Examples
  - JSON containment, array, cardinality, and reference matchers
  - Improved transient example handling
  - Examples that terminate a mock connection
• Studio
  - Edit, import, export, validate, and rename OpenAPI and AsyncAPI examples
  - Swagger views for OpenAPI specifications
  - Rename specifications and update configuration paths
• Insights
  - Support for Provider driver contract and Service view
  - Download dashboard data
  - Submit reports directly from test and mock commands
  - Automatic repository and build metadata detection across CI systems
• Skeptic
  - HTTP lint server
  - API security, health-check, and pagination lint rules
• Platform & Governance
  - Commands to generate, update, and validate Config V3
  - MCP tools for example validation
  - Expanded HTML and CTRF reporting

Trust Layer for AI-Powered API Engineering

• AI-Ready
  - Make every Specmatic capability discoverable, version-aware, machine-readable, and easy for agents to operate safely
  
• AI-Assisted
  - Help agents and engineers design APIs, workflows, examples, dictionaries, mocks, and tests.
• AI-Verified
  - Give agents deterministic feedback on contracts, behavior, security, compatibility, and coverage.
• AI-Autonomous
  - Using guides and sensors build a harness for agents to complete API development tasks autonomously
  - Package the AI-skills, MCP server, scripts and best practices as agent plugin
• Skeptic
  - Expose linting capability as MCP tool
  - Publish SARIF report
• Insights
  - View dashboards for default repo branch or latest build
  - View SARIF report from Linter in Insights

Future Roadmap

• Harness Engineering
  - Optimise the agent plugin
• OpenAPI
  - Callback support
• AsyncAPI
  - Proxy support
  - Schema resiliency testing
• GraphQL
  - Proxy support
  - Example generation
• gRPC
  - Proxy support
  - Example generation
• Studio
  - Auto-fix AsyncAPI, gRPC and GraphQL specifications
  
• Insights
  - Governance for deprecated APIs
  - MCP, WSDL, Redis, and JDBC support
  - Insights MCP Server
• Skeptic
  - Expand protocol support
• Protocols
  - A2A protocol support