Skip to main content
Glama

BlockMag Official Public MCP Server (2024-11-05)

MCP Protocol Free Public Tier Platform License: MIT

Official Model Context Protocol (MCP) server for BlockMag.com β€” the global multi-tenant business operating platform uniting A4 invoicing, multi-warehouse inventory, automated bank reconciliation, freelancer timesheets, biometric staff attendance, and 0%-commission E-Shop & In-Store Scan & Go commerce.

This repository provides instant, zero-authentication access to BlockMag's 6 free public AI tools over both Remote MCP (Streamable HTTP & SSE) and Local Stdio Bridge for Claude Desktop, Cursor, Windsurf, VS Code, ChatGPT, and custom AI agents.


🌐 Live Endpoints & Discovery Manifests

Resource

Canonical Production URL

Auth Required

Public Remote MCP Endpoint (SSE + HTTP POST)

https://blockmag.com/api/mcp/public

None (100% Free)

MCP Discovery Manifest

https://blockmag.com/.well-known/mcp.json

None

OpenAPI 3.1 Schema (ChatGPT Actions)

https://blockmag.com/api/v1/openai/public-schema.json

None

LLM Documentation Index

https://blockmag.com/llms.txt / https://blockmag.com/llms-full.txt

None

Free Online A4 Invoice Generator

https://blockmag.com/tools/invoice-generator

None

Free Timesheet & Overtime Calculator

https://blockmag.com/tools/timesheet-calculator

None

Merchant Cloud POS & E-Shop OS

https://blockmag.com/sellers

Free Plan Available


Related MCP server: eyeot-mcp

πŸ› οΈ Included Free Public MCP Tools (Zero API Key Required)

1. search_public_stores

Searches verified public E-Shop storefronts and merchants on BlockMag Marketplace by store name, industry keyword, country, or city.

  • Parameters:

    • query (string, optional): Store name, industry keyword, or city.

    • country (string, optional): Country filter (e.g., "United Kingdom", "United States", "Romania").

    • limit (integer, optional, default 15): Maximum number of stores to return.

2. search_public_catalog

Searches live products and shelf barcodes (EAN-13 / UPC) across verified public store catalogs on BlockMag, with optional store subdomain and maximum price filters.

  • Parameters:

    • query (string, required): Product name, EAN-13 barcode, or keyword.

    • subdomain (string, optional): Filter within a specific merchant ({subdomain}.blockmag.com).

    • max_price (number, optional): Maximum unit price filter.

    • limit (integer, optional, default 20): Maximum number of products to return.

3. get_public_store_details

Retrieves public storefront details, contact information, currency, and featured catalog items for a specific BlockMag store subdomain.

  • Parameters:

    • subdomain (string, required): Store subdomain (e.g. "freshbakery" for https://freshbakery.blockmag.com).

4. generate_free_invoice

Stateless public calculation engine: computes multi-VAT invoice totals (Net, VAT, Gross across global VAT rates 0%–27%) and generates a direct printable A4 PDF preview URL via BlockMag Free Invoice Generator.

  • Parameters:

    • currency (string, default "EUR"): ISO currency code (GBP, USD, EUR, RON, CHF, etc.).

    • invoice_number (string, optional): Document series and number (e.g. "INV-2026-001").

    • issuer (object, required): { name, tax_id, address }

    • client (object, required): { name, tax_id, address }

    • items (array, required): Array of { description, quantity, unit_price, vat_percent }

5. calculate_timesheet

Stateless public calculation engine: calculates freelancer/contractor billable shift hours, hourly rates, tax deductions, and returns a direct printable A4 Timesheet PDF preview URL via BlockMag Free Timesheet Calculator.

  • Parameters:

    • contractor_name (string, required)

    • client_name (string, optional)

    • hourly_rate (number, required)

    • currency (string, default "EUR")

    • tax_rate (number, default 0)

    • entries (array, required): Array of { date, hours, task_description }

6. verify_invoice_qr

Validates a cryptographic BlockMag invoice verification hash or B2B partner Goods Reception QR code.

  • Parameters:

    • verification_code (string, required): Verification hash or QR token from a BlockMag document.


⚑ Quick Start Configuration

For MCP clients that support remote SSE or Streamable HTTP servers (Cursor, Windsurf, Claude Desktop Remote MCP, Antigravity):

{
  "mcpServers": {
    "blockmag-public": {
      "url": "https://blockmag.com/api/mcp/public"
    }
  }
}

Option B: Local Node.js Stdio Bridge (Zero Dependencies, Node >= 18)

For MCP clients configured via command / stdio:

git clone https://github.com/AddrianC/blockmag-mcp-server.git
cd blockmag-mcp-server

Add to your claude_desktop_config.json or .cursor/mcp.json:

{
  "mcpServers": {
    "blockmag-public": {
      "command": "node",
      "args": ["/absolute/path/to/blockmag-mcp-server/index.mjs"]
    }
  }
}

πŸ” Optional: Authenticated Tenant Hands-Free ERP Mode (24 Additional Tools)

Active merchants on BlockMag.com/sellers can generate a Sanctum MCP Token from Billing β†’ MCP & AI Autonomous to unlock 24 voice-first operational tools on https://blockmag.com/api/mcp/tenant (issuing live invoices, recording payments, autonomous VAT expense categorization, stock & warehouse reception notes, BOM manufacturing recipes, and staff attendance).


Available Tools

6 tools
calculate_timesheetC

Stateless public tool: calculates freelancer/contractor billable hours, rates, tax deductions, and A4 timesheet preview URL.

Inputs: entries (required), hourly_rate (required), contractor_name (required), currency, +2 more.

generate_free_invoiceB

Stateless public tool: generates structured invoice calculation with VAT breakdown and direct A4 printable preview URL (does not save to a tenant account).

Inputs: items (required), client (required), issuer (required), currency, +1 more.

get_public_store_detailsA

Retrieves public storefront details, contact information, currency, and featured catalog items for a specific BlockMag store subdomain.

Inputs: subdomain (required).

search_public_catalogB

Searches for products across verified public store catalogs on BlockMag with optional store subdomain and price filters.

Inputs: query (required), limit, max_price, subdomain.

search_public_storesC

Searches verified public E-Shop stores and companies on BlockMag by name, keyword, country, or city.

Inputs: limit, query, country.

verify_invoice_qrC

Validates an invoice dynamic verification hash or B2B partner QR code.

Inputs: verification_code (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct target: store search, catalog search, store details, invoice generation, invoice verification, and timesheet calculation. The two search tools are separated by resource type (stores vs. products), and the invoice-related tools are separated by action (generate vs. verify).

    Naming Consistency5/5

    All tool names use consistent snake_case and follow a predictable verb_noun pattern: search_public_stores, search_public_catalog, get_public_store_details, generate_free_invoice, verify_invoice_qr, calculate_timesheet. Minor variation in explicitly including 'public' does not undermine the pattern.

    Tool Count5/5

    Six tools is well-scoped for a public server covering store discovery plus a few stateless business calculators. Each tool appears to earn its place without excessive surface area.

    Completeness4/5

    The store side covers search, catalog search, and store details, while the invoice/timesheet side covers generation, verification, and calculation. There are minor gaps such as direct product-detail retrieval or store category browsing, but the core public workflows are represented.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      37 MCP servers for agentic commerce and Brazilian services. Covers Stripe ACP, x402 (Coinbase), AP2 (Google), Google UCP, plus 14 traditional Brazilian payment rails, fiscal, banking, communication, logistics, ERP, identity, and crypto APIs. ~480 tools. Supports stdio and Streamable HTTP.
      279
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      An MCP server that bridges AI agents to the eyeot ERP, exposing ~600 business actions (CRM, sales, stock, HR, finance, etc.) as MCP tools over stdio via OAuth 2.1 authentication.
      33
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to call 16 small, deterministic, read-only tools over a free, no-auth remote streamable HTTP MCP endpoint, covering business idea scoring, price headroom, hotel OTA commissions, open-source SaaS swaps, ads policy notice risk, App Store 4.2 prechecks, and Japan trip planning. Each tool is also exposed as a plain JSON API with OpenAPI docs.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Exposes French electronic invoicing as a local stdio MCP server, letting an AI client create EN 16931-compliant Factur-X invoices with guaranteed legal numbering, client and organization management, and invoice history. It can also submit a generated invoice to a French e-invoicing platform (PDP) after explicit confirmation.
      5
      AGPL 3.0