Quickstart
Get the Billing.net MCP Server running locally in under 5 minutes.
Step 1: Clone the Repository
git clone https://github.com/billing-net/billing.net cd billing.net
Step 2: Install Dependencies
cd backend python3 -m venv venv source venv/bin/activate pip install -r requirements.txt
Step 3: Configure Environment
Create a .env file:
DATABASE_URL=postgresql://billinguser:changeme@localhost/billingnet STRIPE_SECRET_KEY=sk_test_... SMTP_HOST=smtp.postmarkapp.com SMTP_USER=your-postmark-key MCP_ENABLED=true
Step 4: Start the Server
uvicorn app.main:app --host 0.0.0.0 --port 8000
Step 5: Test the API
curl http://localhost:8000/api/health
Expected response:
{
"status": "ok",
"service": "billing.net"
}You're Running!
The Billing.net MCP Server is now active. Start creating invoices, recording usage, or connecting providers.
Next Steps
- Explore the API Reference — see all available endpoints
- Self-Hosting Guide — deploy to production with Docker
- Developer Docs — SDKs and code examples