MCP Server

Model Context Protocol

SimpleWebAPIs exposes all its APIs through the Model Context Protocol (MCP), allowing AI agents and coding tools to call our endpoints directly.

Overview

MCP is an open protocol that standardises how AI applications connect to external tools and data sources. Our MCP server uses Streamable HTTP transport, so there's no local server to run - just point your client at our endpoint.

Every request is authenticated with your API key and subject to the same credit system as our REST endpoints. Playground requests bypass credit checks.

Endpoint

POST https://simplewebapis.com/mcp

Uses Streamable HTTP transport. Include your API key in the X-Api-Key header.

Authentication

Authenticate using the same API key you use for REST endpoints. Pass it in the X-Api-Key header with each MCP request.

Generate and manage API keys from your dashboard.

Available Tools

The MCP server exposes the following tools. Each tool maps directly to one of our REST API endpoints.

Barcode Generator generate_barcode 1 credit

Generate 1D barcodes in popular symbologies including Code 128, EAN-13, UPC-A, and more.

Parameters: text (string, required) , format (string, optional) , width (int, optional) , height (int, optional) , includeText (bool, optional)

CV to JSON Parser parse_cv 5 credits

Convert unstructured CV or resume text into structured JSON data using AI-powered parsing.

Parameters: text (string, required)

DNS Lookup lookup_dns 1 credit

Look up DNS records for any domain name including A, AAAA, MX, NS, TXT, and CAA records.

Parameters: domain (string, required)

Data Matrix Generator generate_data_matrix 1 credit

Generate Data Matrix 2D barcodes from any text or data.

Parameters: text (string, required) , size (int, optional)

Gender Prediction predict_gender 1 credit

Statistically predict the likely gender and probability for a given first name based on worldwide name frequency data.

Parameters: name (string, required) , country (string, optional)

OpenGraph Data Extractor extract_open_graph 1 credit

Extract OpenGraph metadata from any URL including title, description, image, and custom properties.

Parameters: url (string, required)

PDF Invoice Generator generate_invoice 2 credits

Generate professional PDF invoices with line items, addresses, and custom styling.

Parameters: invoiceData (string, required — JSON with invoiceNumber, dates , seller , customer , items , comments , currency)

PDF Packing Slip Generator generate_packing_slip 2 credits

Generate professional PDF packing slips with line items, tracking information, and shipping details.

Parameters: packingSlipData (string, required — JSON with slipNumber, shipDate , addresses , items , trackingNumber , carrier , notes)

PDF Purchase Order Generator generate_purchase_order 2 credits

Generate professional PDF purchase orders with line items, addresses, and tax calculations.

Parameters: purchaseOrderData (string, required — JSON with orderNumber, dates , addresses , items , taxRate , notes)

PDF Quote Generator generate_quote 2 credits

Generate professional PDF quotes with line items, tax and discount rates, and validity dates.

Parameters: quoteData (string, required — JSON with quoteNumber, dates , addresses , items , taxRate , discountRate , notes , terms)

PDF Receipt Generator generate_receipt 2 credits

Generate professional PDF receipts with line items, payment details, and custom styling.

Parameters: receiptData (string, required — JSON with receiptNumber, date , addresses , items , amountPaid , paymentMethod , transactionId)

QR Code Generator generate_qr_code 1 credit

Generate customisable QR codes from URLs, text, or any data.

Parameters: text (string, required) , size (int, optional)

Stylised QR Code Generator generate_stylised_qr_code 2 credits

Generate custom QR codes with branded colours, gradients, and a centred logo.

Parameters: text (string, required) , darkColor (string, optional) , lightColor (string, optional) , gradientColors (string[], optional) , gradientDirection (string, optional) , moduleShape (string, optional) , finderPatternShape (string, optional) , logoUrl (string, optional)

Text Info analyze_text 1 credit

Analyse any text and get detailed statistics including readability scores, word frequency, and pattern detection.

Parameters: text (string, required)

WHOIS Lookup lookup_whois 1 credit

Look up WHOIS registration data for any domain name including registrar, dates, and nameservers.

Parameters: domain (string, required)

Client Configuration

Add SimpleWebAPIs as an MCP server in your client's configuration. Here are examples for popular tools:

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "simplewebapis": {
      "url": "https://simplewebapis.com/mcp",
      "headers": {
        "X-Api-Key": "swa_your_api_key_here"
      }
    }
  }
}

Generic HTTP Client

For any MCP-compatible client that supports Streamable HTTP, point it at:

Endpoint:  https://simplewebapis.com/mcp
Auth:       X-Api-Key header
Transport:  Streamable HTTP (POST)

Credits & Billing

MCP tool calls consume credits just like REST API calls. Check each tool's credit cost above. Your remaining credits and usage are visible on the dashboard.