MCP Servers

billingo-mcp

MCP server for the Billingo V3 Hungarian invoicing API. Manage invoices, partners, products, spendings, and bank accounts from any MCP client.

README

billingo-mcp

MCP server for the Billingo V3 Hungarian invoicing API. Manage invoices, partners, products, spendings, and bank accounts from any MCP client.

Quick Start

Get your API key from Billingo API settings
Add to your Claude Code settings (~/.claude/settings.json) or Claude Desktop config:

{
  "mcpServers": {
    "billingo": {
      "command": "npx",
      "args": ["-y", "@daniel.barta/billingo-mcp"],
      "env": {
        "BILLINGO_API_KEY": "your-api-key"
      }
    }
  }
}

Restart Claude and start managing your invoices.

Configuration

Environment Variable	Required	Default	Description
`BILLINGO_API_KEY`	Yes	--	Your Billingo API key
`BILLINGO_MOCK`	No	`false`	Set to `true` for mock mode (no API calls)

Mock mode is activated automatically when no API key is provided, or explicitly with BILLINGO_MOCK=true. Useful for development and testing.

Tools

Documents

Tool	Description
`list_documents`	List invoices with filters (partner, status, date range, type, payment method)
`create_document`	Create invoices, proformas, advance invoices, or drafts
`get_document`	Get document details by ID
`cancel_document`	Cancel (storno) a document
`send_document`	Send document via email
`download_document`	Download document as PDF
`get_document_public_url`	Get public URL for a document
`update_payment`	Record or update payment on a document

Partners

Tool	Description
`list_partners`	List partners with search
`create_partner`	Create a new partner (with address, tax info)
`get_partner`	Get partner details by ID
`update_partner`	Update an existing partner

Products

Tool	Description
`list_products`	List products
`create_product`	Create a new product
`get_product`	Get product details by ID
`update_product`	Update an existing product

Spendings

Tool	Description
`list_spending`	List spendings with filters
`create_spending`	Create a spending entry (with line items and VAT)
`get_spending`	Get spending details by ID

Bank Accounts

Tool	Description
`list_bank_accounts`	List bank accounts
`create_bank_account`	Create a new bank account
`get_bank_account`	Get bank account details by ID
`update_bank_account`	Update an existing bank account

Utilities

Tool	Description
`check_tax_number`	Validate a Hungarian tax number via NAV
`get_organization`	Get your own organization data
`get_currency_rates`	Get exchange rates
`list_document_blocks`	List invoice numbering sequences

Development

git clone https://github.com/bartadaniel/billingo-mcp.git
cd billingo-mcp
npm install
npm run build

Use the local build in your config:

{
  "mcpServers": {
    "billingo": {
      "command": "node",
      "args": ["path/to/billingo-mcp/bin/billingo-mcp.js"],
      "env": {
        "BILLINGO_API_KEY": "your-api-key"
      }
    }
  }
}

Mock Mode

Run without an API key for development:

npm run dev

This starts the server with BILLINGO_MOCK=true, returning realistic fixture data for all tools.

License

MIT

Recommended Servers

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official

Featured

TypeScript

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official

Featured

Local

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official

Featured

TypeScript

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official

Featured

Python

E2B

Using MCP to run code via e2b.

Official

Featured

Neon Database

MCP server for interacting with Neon Management API and databases

Official

Featured

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official

Featured

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official

Featured