> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mercoa.com/sdks/javascript/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 the Browser or Node.js, the official [@mercoa/javascript](https://github.com/mercoa-finance/javascript) package is the easiest way to interact with the Mercoa API.

The SDK is written in [TypeScript](https://typescript.dev) and includes type definitions for all resources, requests, and responses.

## Installation

```bash
npm install --save @mercoa/javascript
# or
yarn add @mercoa/javascript
```

## Initialization

```javascript
import { Mercoa, MercoaClient } from "@mercoa/javascript"

// If using on the server with Node.js
const mercoa = new MercoaClient({
  token: 'YOUR_API_KEY',
});

// If using in the browser
const mercoa = new MercoaClient({
  token: 'YOUR_CLIENT_JWT',
});

const entity = mercoa.entity.get("YOUR_ENTITY_ID")

console.log(entity)
```