​
Overview

The Maesn MCP Server acts as a bridge between your AI agent and the Maesn Unified API. Think of it as a translator: instead of manually writing API calls, your agent can use the MCP to access accounting data and perform actions across our 20+ supported accounting systems through a single unified interface.

​
How it works

Once connected to an agent like Claude, the MCP server lets you interact with the Unified API through simple, natural conversations. You don’t need to know how to structure an API call, the MCP takes care of that for you.
  1. Ask your question in plain text Example: “Show me all unpaid invoices for Company A.”
  2. The MCP Server handles the request It validates your input, applies the right filters, injects authentication, and makes the correct call to the Unified API.
  3. Get clear results back The server returns structured data, and your agent explains it to you in plain language complete with invoice IDs, amounts, dates, and any other relevant details.
Almost all endpoints from the Maesn Unified API are available through our MCP server. You can explore the currently supported resources here. Whether you need to retrieve, create, or update data, the MCP server provides full support for the listed resources.

​
Getting Started

You can now try out our MCP server locally in just a few steps! Start by cloning the GitHub repository and installing the dependencies: 
git clone https://github.com/maesndev/maesn-mcp.git
cd maesn-mcp
npm install
Next, configure your agent. For Claude Desktop, this means updating your claude_desktop_configuration.json file so it knows how to connect to the MCP server: 
{
  "mcpServers": {
    "maesn-mcp": {
      "command": "node",
      "args": [
        "<ABSOLUTE_PATH>/apps/maesn-mcp/dist/main.js"
      ]
    }
  }
}
Finally, start the server using: 
npx nx serve maesn-mcp
For more detailed configuration instructions, check out the README. Once the server is running and your agent is configured, you can start asking it to pull customer data, list invoices, create new bills, or anything else you want to try out. Don’t have an API key for the MCP server? No worries! You can get a free API key from our website at app.maesn.dev/signin. Make sure to configure your credentials in your environment file before using the MCP server.