---
id: mcp
title: Model Context Protocol (MCP) Server
sidebar_label: MCP Server
description: Connect GAAPx directly to Claude Desktop, Cursor, Windsurf, and autonomous AI agents using the Model Context Protocol.
keywords:
  - GAAPx MCP server
  - Model Context Protocol accounting
  - Claude Desktop MCP integration
  - Cursor AI accounting tool
author: GAAPx AI & Developer Ecosystem Team
last_updated: 2026-10-02
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Model Context Protocol (MCP) Server

> **Quick Summary:** GAAPx provides a first-class remote **Model Context Protocol (MCP)** server. AI coding assistants and agents (like Claude Desktop, Cursor, and Antigravity) can directly query live trial balances, inspect ASC 606 revenue schedules, search contract terms, and run automated accounting compliance checks.

---

## Authentication & API Keys

To connect any MCP client:
1. Open the **[GAAPx Admin Console](https://app.gaapx.com/admin/api)**.
2. Under **Generate an API key**, select your permissions (Full Access or Read-Only).
3. Copy your generated token (prefixed with `gx_live_...`).

---

## Connection Configuration

<Tabs>
<TabItem value="claude" label="Claude Desktop" default>

Add the following to your `claude_desktop_config.json`:

- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "gaapx": {
      "url": "https://app.gaapx.com/api/mcp",
      "headers": {
        "Authorization": "Bearer gx_live_YOUR_KEY_HERE"
      }
    }
  }
}
```

</TabItem>

<TabItem value="cursor" label="Cursor">

Add to your `.cursor/mcp.json` file:

```json
{
  "mcpServers": {
    "gaapx-accounting": {
      "url": "https://app.gaapx.com/api/mcp",
      "headers": {
        "Authorization": "Bearer gx_live_YOUR_KEY_HERE"
      }
    }
  }
}
```

</TabItem>

<TabItem value="stdio" label="Stdio (npx CLI)">

```json
{
  "mcpServers": {
    "gaapx": {
      "command": "npx",
      "args": ["-y", "@gaapx/mcp"],
      "env": {
        "GAAPX_API_KEY": "gx_live_YOUR_KEY_HERE"
      }
    }
  }
}
```

</TabItem>
</Tabs>

---

## Live MCP Tools Reference

### 1. `get_ledger_summary`
Fetches trial balance totals, active journal entries, or Note 6 disclosure schedules.

**Parameters Schema:**
```json
{
  "period": { "type": "string", "description": "Accounting period (e.g. 2026-Q3, 2026-09)" },
  "basis": { "type": "string", "enum": ["GAAP", "IFRS"], "default": "GAAP" },
  "entity_id": { "type": "string", "description": "Optional UUID for scoped legal entity" }
}
```

### 2. `get_revenue_waterfall`
Retrieves ASC 606 revenue recognition waterfalls, deferred balances, and unrecognized contract values.

### 3. `search_contracts`
Searches Master Service Agreements (MSAs), order forms, and amendments by customer name, dates, or terms.

### 4. `check_asc606_compliance`
Runs automated AI validation across revenue allocations, standalone selling prices (SSP), and contract modifications.