BlockMag Public MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BlockMag Public MCP Server Look up the product with barcode 4006381333931 and show its price"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BlockMag Official Public MCP Server (2024-11-05)
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) |
| None (100% Free) |
MCP Discovery Manifest |
| None |
OpenAPI 3.1 Schema (ChatGPT Actions) |
| None |
LLM Documentation Index |
| None |
Free Online A4 Invoice Generator | None | |
Free Timesheet & Overtime Calculator | None | |
Merchant Cloud POS & E-Shop OS | 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, default15): 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, default20): 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"forhttps://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, default0)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
Option A: Direct Remote MCP Connection (Recommended β Zero Install)
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-serverAdd 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).
π Official Links
Marketplace & In-Store Scan & Go: https://blockmag.com
Merchant Cloud POS, Invoicing & ERP: https://blockmag.com/sellers
Technology Radar & AI Architecture: https://blockmag.com/tech-radar
Free Online Invoice Generator: https://blockmag.com/tools/invoice-generator
Free Timesheet & Hours Calculator: https://blockmag.com/tools/timesheet-calculator
Available Tools
6 toolscalculate_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
Scored across 6 tools
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).
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.
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.
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
Remote streamable-HTTP MCP server running on a single Cloudflare Worker. Your assistant gets live Airbnb, Amazon, Booking.com, Google Flights, Maps and Reddit data, social search on X, Instagram and TikTok, the Meta Ad Library, and image/video generation without any keys. Connect your own accounts to let it send WhatsApp or Telegram messages, work an IMAP inbox, manage Meta Ads campaigns and publish to X and LinkedIn. OAuth 2.1 with PKCE; stored credentials are AES-256-GCM encrypted.
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
Free OpenAI-compatible inference with signed provenance receipts and 3 focused MCP tools.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenance37 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.279MIT
- AlicenseCqualityDmaintenanceAn 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.331MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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
- AlicenseNot gradedqualityBmaintenanceExposes 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.5AGPL 3.0