@coderseranpm/mcp

Generate invoices, check Domain Rating, look up IP metadata, and manage browser notes from Claude, Codex, Cursor, and any MCP-capable agent.

This is a local stdio Model Context Protocol server for Codersera tools. It wraps the free Codersera invoice generator, Domain Rating checker, IP lookup, and Browser Notes Taker: create invoice JSON, calculate totals, write printable HTML/PDF/JSON files on your machine, check Ahrefs Domain Rating, inspect IP geolocation/ASN data, and create or manage saved notes in your Codersera account.

Codersera MCP requires a signed-in Codersera account and API key. Generate the key from https://codersera.com/tools/invoice-generator#mcp, then pass it as CODERSERA_MCP_API_KEY. The MCP server runs locally. Invoice rendering stays local; online tools call Codersera only for the specific domains, IPs, or notes you ask the agent to work with.

The tools register and stay discoverable even before the key is verified. The key is checked lazily the first time you call a value-producing tool, so a missing or invalid key returns a clear, actionable error from that tool instead of silently hiding every tool from your agent. The read-only info tools (list_invoice_templates, list_supported_currencies, get_invoice_schema) work without a key.

Setup

Claude Code

CODERSERA_MCP_API_KEY='cw_live_...' claude mcp add --scope user codersera -- npx -y @coderseranpm/mcp

Codex

CODERSERA_MCP_API_KEY='cw_live_...' codex mcp add codersera -- npx -y @coderseranpm/mcp

Or add it to ~/.codex/config.toml:

[mcp_servers.codersera]
command = "npx"
args = ["-y", "@coderseranpm/mcp"]
env = { CODERSERA_MCP_API_KEY = "cw_live_..." }

Claude Desktop / Cursor / Windsurf

Edit the matching user-level MCP config:

{
    "mcpServers": {
        "codersera": {
            "command": "npx",
            "args": ["-y", "@coderseranpm/mcp"],
            "env": {
                "CODERSERA_MCP_API_KEY": "cw_live_..."
            }
        }
    }
}

Local tarball fallback

If npm is temporarily unavailable, the same package is also mirrored at:

CODERSERA_MCP_API_KEY='cw_live_...' npx -y --package https://codersera.com/mcp/codersera-mcp-0.2.2.tgz codersera-mcp

Tools

| Tool | What it does | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | create_invoice | Build a normalized invoice from supplier, buyer, lines, tax, discount, and payment fields. Returns JSON, totals, and a formatted summary. | | calculate_invoice_totals | Recompute line totals, tax breakdown, discounts, withholding, shipping, and amount due for an invoice payload. | | write_invoice_html | Write a standalone printable .html invoice to local disk. Open it in a browser and Save as PDF. | | write_invoice_pdf | Render a real .pdf using a local Chrome/Chromium/Edge/Brave. Falls back to writing .html (no error) if no browser is found. | | write_invoice_json | Write the normalized invoice JSON to local disk for accounting or CRM import. | | check_domain_rating | Check Ahrefs Domain Rating (DR 0-100) for one domain or URL. | | bulk_check_domain_rating | Check Ahrefs Domain Rating for up to 10 domains or URLs in one request. | | lookup_ip | Look up geolocation, ASN, ISP, timezone, and country metadata for one IPv4/IPv6 address or the caller IP. | | bulk_lookup_ips | Look up IP metadata for up to 10 IPv4/IPv6 addresses in one request. | | create_browser_note | Create a note in Codersera Browser Notes Taker from plain text or sanitized HTML. | | list_browser_notes | List recent Codersera Browser Notes, optionally filtered by title/excerpt search. | | read_browser_note | Read one note by id, including sanitized HTML and plain text. | | update_browser_note | Update a note title and/or body. Plain text is converted to simple browser-editor HTML when HTML is omitted. | | delete_browser_note | Delete one note by id. | | share_browser_note | Publish or unpublish a note and return its Codersera public share URL when published. | | list_invoice_templates | List template ids accepted by the web invoice generator, each with a short description. The MCP renderer uses a clean printable layout. | | list_supported_currencies | List common supported invoice currencies and default locales. | | get_invoice_schema | Return a compact field guide for agent prompting. |

Domain Rating tools

check_domain_rating accepts a single target domain or URL:

{ "target": "https://codersera.com/tools/domain-rating-checker" }

bulk_check_domain_rating accepts targets, up to 10 domains or URLs:

{ "targets": ["codersera.com", "ahrefs.com", "stripe.com"] }

Both tools normalize URLs to bare domains, skip duplicates in bulk mode, and return { domain, dr } rows with dr on Ahrefs' 0-100 scale. The checks call Codersera's Domain Rating API, which proxies Ahrefs' public Domain Rating endpoint.

IP Lookup tools

lookup_ip accepts an optional ip. If omitted, Codersera looks up the caller IP seen by its API:

{ "ip": "8.8.8.8" }

bulk_lookup_ips accepts ips, up to 10 addresses:

{ "ips": ["8.8.8.8", "1.1.1.1"] }

Responses include country, region, city, latitude/longitude, timezone, ASN, organization, ISP, hostname when available, and source metadata.

Browser Notes tools

Use create_browser_note to save a note to Codersera Browser Notes Taker:

{
    "title": "Research notes",
    "content_text": "Key finding\n\nFollow-up item"
}

Use list_browser_notes to find note ids, then read_browser_note, update_browser_note, delete_browser_note, or share_browser_note. Publishing a note returns a public https://codersera.com/n/... share URL.

write_invoice_pdf

Same arguments as write_invoice_html (plus outputPath / overwrite), but it produces a true PDF. It uses puppeteer-core driving a browser you already have installed — it never downloads Chromium. The server probes, in order:

1. PUPPETEER_EXECUTABLE_PATH, CHROME_PATH, CHROME_BIN
2. Common Chrome / Chromium / Microsoft Edge / Brave install paths for your OS

If a browser is found it returns { path, invoiceNumber, amountDue, renderer: "chrome" }. If none is found (or rendering fails), it gracefully degrades: it writes the HTML to the same path with a .html extension and returns a non-error result with pdf: false and a message telling you to open it and Save as PDF, or set PUPPETEER_EXECUTABLE_PATH and retry. The tool never crashes.

Invoice options

These apply to every invoice-producing tool:

• showTax — the Tax column auto-hides when no line carries a positive tax rate (no Tax header, no per-row tax cell, no Tax $0.00 row). Pass showTax: true or false to force it on or off.
• bankAccounts — an array (max 6) of structured remittance details: { holder, bank, accountNumber, routingNumber, iban, bic, swift, currency, notes }. Each is rendered as a labeled "Remittance" card showing only the fields you filled in. The freeform paymentInstructions string still renders too.
• omitDueDate — set true to drop the due date entirely (no Due line).
• Structured address — supplier.address and buyer.address accept either a plain string or { line1, line2, city, region, postalCode, country }, which is joined into a clean multi-line address.
• logoUrl — accepts an http(s) URL, a data: URI, or a local file path (png/jpg/jpeg/gif/svg/webp). Local files are read and inlined; an unreadable logo is skipped silently rather than failing the invoice. The logo is rendered at the top-left of the invoice.

Example prompt

Using Codersera MCP, generate an invoice for Acme Inc. from Jane Doe LLC. Invoice number INV-2026-0042, USD, Net 14. Line: "React performance audit", 12 hours at 95/hour, VAT 0. Write the printable HTML to ~/Desktop.

Using Codersera MCP, check Domain Rating for codersera.com, ahrefs.com, and stripe.com, then sort the results from highest DR to lowest.

Using Codersera MCP, look up 8.8.8.8 and 1.1.1.1, then summarize the country, ASN, organization, and timezone for each.

Using Codersera MCP, save these meeting notes to Browser Notes Taker with the title "Launch checklist", then publish the note and give me the share URL.

Privacy and file writes

The server verifies CODERSERA_MCP_API_KEY lazily — the first time you call a value-producing tool, it calls Codersera once and caches the result. After that, invoice tools run locally. Domain Rating tools call Codersera's DR API for the domains you provide; Codersera then proxies Ahrefs' public Domain Rating endpoint. IP Lookup tools call Codersera's IP Lookup API for the supplied addresses. Browser Notes tools read and write notes in the Codersera account that owns the API key.

It writes files only when you call write_invoice_html, write_invoice_pdf, or write_invoice_json. If outputPath is omitted, it writes to your OS temp directory. Existing files are not overwritten unless overwrite: true is passed. write_invoice_pdf renders through a browser already installed on your machine and never downloads one.