> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mercoa.com/sdks/java/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mercoa.com/_mcp/server.

If you're working with Java, the official [mercoa](https://central.sonatype.com/artifact/com.mercoa/mercoa) package is the easiest way to interact with the Mercoa API.

## Installation

### Gradle users

Add this dependency to your project's build file:

```groovy
implementation 'com.mercoa:mercoa:0.6.4'
```

### Maven users

Add this dependency to your project's POM:

```xml
<dependency>
    <groupId>com.mercoa</groupId>
    <artifactId>mercoa</artifactId>
    <version>0.6.4</version>
</dependency>
```

## Usage

```java
Mercoa client = Mercoa.builder()
    .token("MERCOA_API_KEY")
    .build();

var response = client.entity().get("YOUR_ENTITY_ID");

System.out.println(response.getId());
```