Package Exports

bill-mcp-server
bill-mcp-server/mcpServer.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (bill-mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

⚠️ DEVELOPMENT - DO NOT USE

This project is actively under development and not production-ready. Do not use this project with live data or in production environments. The API, data models, and behavior may change without notice.

bill-mcp-server

Model Context Protocol (MCP) server, providing tools for managing vendors, bills, and payments.

🚀 Quick Start

Run with npx (No installation needed)

npx bill-mcp-server

Use in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "bill": {
      "command": "npx",
      "args": ["-y", "bill-mcp-server"],
      "env": {
        "USERNAME": "your-email@example.com",
        "PASSWORD": "your-password",
        "ORGANIZATION_ID": "your-org-id",
        "DEV_KEY": "your-dev-key"
      }
    }
  }
}

Restart Claude Desktop and start asking about your BILL data!

📋 Available Tools

api_login - Authenticate and get session ID
get_vendor_list - List all vendors
get_vendor_details - Get specific vendor information
get_list_of_bills - List all bills
get_bill_details - Get specific bill information
get_payments - List all payments
get_payment_details - Get specific payment information
get_api_session_details - Check session status

🔐 Authentication

Set these environment variables:

USERNAME
PASSWORD
ORGANIZATION_ID
DEV_KEY

�� Testing

Test with MCP Inspector:

npx @modelcontextprotocol/inspector npx -y bill-mcp-server

🌐 Running Modes

STDIO Mode (Default)

For Claude Desktop, MCP Inspector:

npx bill-mcp-server

HTTP Mode

For web applications:

npx bill-mcp-server --streamable-http

Runs on http://localhost:3001/mcp

SSE Mode

For server-sent events:

npx bill-mcp-server --sse

📦 Global Installation

npm install -g bill-mcp-server
bill-mcp-server

🎯 Use Cases

Invoice Management: Query and manage bills
Vendor Operations: List and search vendors
Payment Tracking: Monitor payment status
Financial Reporting: Extract financial data
Automation: Integrate with AI assistants like Claude

⚡ Example Usage

After setup in Claude Desktop, ask:

"Show me all vendors"
"Get details for vendor ID abc123"
"List all unpaid bills"
"What payments were made this month?"