# Mokksy

> Mokksy and AI-Mocks - mock HTTP APIs with real-world behavior for Java and Kotlin integration tests

## Docs


- [Quick Start (5 minutes)](https://mokksy.dev/docs/mokksy/quick-start.md): Quick Start (5 minutes)
- [First integration test](https://mokksy.dev/docs/mokksy/first-integration-test.md): First integration test
- [Stubbing responses](https://mokksy.dev/docs/mokksy/stubbing.md): Stubbing responses
- [Request matching](https://mokksy.dev/docs/mokksy/request-matching.md): Match incoming requests with path, header, body, predicate, and call matchers, then resolve conflicts with specificity and priority.
- [Verification and request journal](https://mokksy.dev/docs/mokksy/verification.md): Verification and request journal
- [Multipart and file uploads](https://mokksy.dev/docs/mokksy/multipart.md): Multipart and file uploads
- [Streaming and SSE](https://mokksy.dev/docs/mokksy/streaming.md): Server-Sent Events (SSE) enable servers to push updates to clients over a single HTTP connection. The provided code demonstrates how to use mokksy to simulate an SSE stream and verify its response in both Kotlin and Java.
- [Failure simulation](https://mokksy.dev/docs/mokksy/failure-simulation.md): Failure simulation
- [File-based configuration](https://mokksy.dev/docs/mokksy/file-config.md): File-based configuration
- [Docker](https://mokksy.dev/docs/mokksy/docker.md): Docker
- [Ktor integration](https://mokksy.dev/docs/mokksy/ktor.md): Embed Mokksy directly inside a Ktor application for integration tests, internal API simulation, and authenticated stub routes.

- [Anthropic](https://mokksy.dev/docs/ai-mocks/anthropic.md): Anthropic
- [OpenAI](https://mokksy.dev/docs/ai-mocks/openai.md): OpenAI
- [Gemini](https://mokksy.dev/docs/ai-mocks/gemini.md): Gemini
- [Ollama](https://mokksy.dev/docs/ai-mocks/ollama.md): Ollama
- [A2A Protocol](https://mokksy.dev/docs/ai-mocks/a2a.md): Agent2Agent (A2A) Protocol

- [Spring Boot](https://mokksy.dev/docs/integrations/spring-boot.md): Use Mokksy as a mock HTTP server in Spring Boot integration tests by pointing application properties, RestClient, or WebClient at mokksy.baseUrl().
- [Quarkus](https://mokksy.dev/docs/integrations/quarkus.md): Test Quarkus applications against Mokksy or AI-Mocks by replacing outbound HTTP and AI provider dependencies with deterministic local endpoints.
- [LangChain4j](https://mokksy.dev/docs/integrations/langchain4j.md): Use AI-Mocks with LangChain4j to test provider-backed chat and streaming flows without real OpenAI, Anthropic, or Ollama calls.
- [Spring AI](https://mokksy.dev/docs/integrations/spring-ai.md): Test Spring AI clients against provider-compatible AI-Mocks servers for deterministic OpenAI and Gemini behavior, including streaming.
- [OpenAI Java SDK](https://mokksy.dev/docs/integrations/openai-sdk.md): Use AI-Mocks OpenAI with the official openai-java SDK for deterministic chat, streaming, embeddings, moderation, and error-path integration tests.
- [Anthropic Java SDK](https://mokksy.dev/docs/integrations/anthropic-sdk.md): Use AI-Mocks Anthropic with the official Anthropic Java SDK for deterministic Messages API and streaming integration tests.
- [Koog](https://mokksy.dev/docs/integrations/koog.md): Test Koog applications against AI-Mocks provider endpoints. This guide uses a verified OpenAI-backed Spring Boot example for chat, streaming, moderation, and failure paths.

- [Mokksy vs WireMock](https://mokksy.dev/docs/compare/wiremock.md): Compare Mokksy and WireMock for HTTP integration testing, SSE, chunked streaming, deterministic failures, and Kotlin-first JVM tests.