# Lightning Tools

Reliable, quick, efficient API tools to help AI agents perform better.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add donovanh/lightning-tools

# Browse available tools
npx -y @smithery/cli@latest tool list donovanh/lightning-tools

# Get full schema for a tool
npx -y @smithery/cli@latest tool get donovanh/lightning-tools buy_credits

# Call a tool
npx -y @smithery/cli@latest tool call donovanh/lightning-tools buy_credits '{}'
```

## Direct MCP Connection

Endpoint: `https://lightning-tools--donovanh.run.tools`

## Tools (17)

- `buy_credits` — Purchase Lightning Tools credits via Bitcoin Lightning invoice. Costs N sats = N credits.
- `verify_payment` — Confirm a Lightning payment and receive your API key.
- `set_api_key` — Store an existing Lightning Tools API key and unlock all service tools.
- `check_balance` — Return the current credit balance for your active API key.
- `email-validator` — Validates an email address and returns a comprehensive quality signal including syntax, DNS, MX, disposable check, role…
- `calculator` — Evaluates arithmetic, algebra, trigonometry, logarithms, unit conversions, and natural language math. Accepts mathjs sy…
- `qr-code` — Generates a QR code as a base64 PNG string or SVG string. Cost: 1 credit per call. Idempotency-Key header is recommende…
- `extract-text` — Fetches a URL and extracts clean readable text using Mozilla Readability. Returns title, plain text, clean HTML, excerp…
- `phone-validator` — Validates and parses a phone number using libphonenumber-js. Returns country, type (MOBILE/FIXED_LINE/VOIP/etc.), and f…
- `date-utils_today` — Returns the current date, day of week, UTC offset, DST status, working day status, week number, quarter, days until mon…
- `date-utils_convert-time` — Converts an ISO 8601 datetime from one IANA timezone to another, including UTC offset and DST info. Cost: 1 credit. Cos…
- `date-utils_is-working-day` — Returns whether a date is a working day for a given country, including holiday details if not. Cost: 1 credit. Costs 1 …
- `date-utils_next-working-day` — Finds the next (or previous) working day after a given date, skipping weekends and public holidays. Cost: 1 credit. Cos…
- `date-utils_add-working-days` — Adds N working days to a date (negative = backward), skipping weekends and public holidays. Cost: 1 credit. Costs 1 cre…
- `date-utils_count-working-days` — Counts working days between start and end (inclusive), excluding weekends and public holidays. Cost: 1 credit. Costs 1 …
- `date-utils_meeting-windows` — Returns working day availability for 2-5 countries over a date range (max 90 days), identifying days when all countries…
- `date-utils_timezone-overlap` — Finds the UTC window where all specified timezones are simultaneously within working hours. Cost: 1 credit. Costs 1 cre…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get donovanh/lightning-tools <tool-name>
```