publicsofttools-mcp

Name: publicsofttools-mcp
Author: DrEjazAhmed

by DrEjazAhmed

Overview Schema Source Related Servers Discussions Admin

JavaScript

Remote

PublicSoftTools MCP Server

Give any MCP-compatible AI agent (Claude, Cursor, Windsurf) access to 14 utility tools from PublicSoftTools.

npm: npx publicsofttools-mcp
API docs: https://www.publicsofttools.com/docs
Get a key: https://www.publicsofttools.com/account/api-keys

Tools included

Tool	Endpoint	Description
`generate_qr_code`	`POST /api/v1/util/qr`	QR code as base64 PNG or raw SVG
`generate_hash`	`POST /api/v1/util/hash`	MD5, SHA-1, SHA-256, SHA-384, SHA-512
`generate_uuid`	`GET /api/v1/util/uuid`	UUID v4 — up to 100 at once
`encode_decode_base64`	`POST /api/v1/util/base64`	Encode or decode, with URL-safe variant
`generate_password`	`POST /api/v1/util/password`	Cryptographically secure password
`lookup_ip`	`GET /api/v1/ip/lookup`	Geolocation, ISP, ASN, proxy/VPN detection
`check_ssl`	`GET /api/v1/domain/ssl`	SSL certificate details + days remaining
`lookup_dns`	`GET /api/v1/domain/dns`	A, AAAA, MX, TXT, CNAME, NS, SOA records
`whois_lookup`	`GET /api/v1/domain/whois`	Domain registrar, dates, nameservers
`compress_pdf`	`POST /api/v1/pdf/compress`	Reduce PDF file size (max 4 MB)
`merge_pdfs`	`POST /api/v1/pdf/merge`	Combine 2–20 PDFs into one
`split_pdf`	`POST /api/v1/pdf/split`	Split by page range or every N pages
`pdf_to_word`	`POST /api/v1/pdf/to-word`	Convert PDF to editable .docx
`unlock_pdf`	`POST /api/v1/pdf/unlock`	Remove permission restrictions

Related MCP server: QuickHelp

Prerequisites

Node.js 18+ (required for native fetch support)
A PublicSoftTools API key — get one free (1,500 calls/month, no credit card)

Install & configure

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json

{
  "mcpServers": {
    "publicsofttools": {
      "command": "npx",
      "args": ["-y", "publicsofttools-mcp"],
      "env": {
        "PST_API_KEY": "your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. The tools will appear in the tools panel.

Cursor

Open Settings → MCP and add:

{
  "publicsofttools": {
    "command": "npx",
    "args": ["-y", "publicsofttools-mcp"],
    "env": { "PST_API_KEY": "your_api_key_here" }
  }
}

Windsurf

Open Settings → MCP Servers and add the same JSON block as Cursor above.

Tool reference

All tools require the PST_API_KEY environment variable. All file inputs/outputs use base64-encoded content.

`generate_qr_code`

Generate a QR code image for any text, URL, or data.

Parameters

Name	Type	Required	Default	Description
`text`	string	yes	—	Text, URL, or data to encode
`size`	number	no	256	Output size in pixels (64–1024)
`format`	`"png"` \| `"svg"`	no	`"png"`	Output image format
`dark`	string	no	`"#000000"`	Dark module color (hex)
`light`	string	no	`"#ffffff"`	Light module color (hex)
`error_correction`	`"L"` \| `"M"` \| `"Q"` \| `"H"`	no	`"M"`	Error correction level

Response

{
  "image": "data:image/png;base64,iVBORw0...",
  "format": "png",
  "size": 256
}

For format: "svg", image is a raw SVG string instead of a data URL.

`generate_hash`

Hash any text. Omit algorithm to get all five hashes in one call.

Parameters

Name	Type	Required	Default	Description
`text`	string	yes	—	Text to hash (max 100,000 chars)
`algorithm`	`"md5"` \| `"sha1"` \| `"sha256"` \| `"sha384"` \| `"sha512"`	no	all	Hash algorithm
`encoding`	`"hex"` \| `"base64"`	no	`"hex"`	Output encoding

Response (all algorithms)

{
  "hashes": {
    "md5":    "5f4dcc3b5aa765d61d8327deb882cf99",
    "sha1":   "5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8",
    "sha256": "5e884898da28047151d0e56f8dc629277...",
    "sha384": "a8b64babd0aca91a59bdbb7761b421d4...",
    "sha512": "b109f3bbbc244eb82441917ed06d618b..."
  },
  "encoding": "hex",
  "input_length": 8
}

`generate_uuid`

Generate UUID v4 values in batch.

Parameters

Name	Type	Required	Default	Description
`count`	number	no	1	Number of UUIDs to generate (1–100)

Response

{
  "uuids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  ],
  "count": 2
}

`encode_decode_base64`

Encode text to base64 or decode base64 back to plain text.

Parameters

Name	Type	Required	Default	Description
`text`	string	yes	—	Input text (max 500,000 chars)
`action`	`"encode"` \| `"decode"`	yes	—	Operation to perform
`url_safe`	boolean	no	false	Use URL-safe variant (`-` and `_` instead of `+` and `/`)

Response

{
  "result": "aGVsbG8gd29ybGQ=",
  "action": "encode",
  "url_safe": false,
  "input_length": 11,
  "output_length": 16
}

`generate_password`

Generate a cryptographically secure random password.

Parameters

Name	Type	Required	Default	Description
`length`	number	no	16	Password length (8–128)
`uppercase`	boolean	no	true	Include uppercase letters (A–Z)
`numbers`	boolean	no	true	Include digits (0–9)
`symbols`	boolean	no	true	Include symbols (!@#$…)

Response

{
  "password": "kR7#mQ2@xZ9!wP4$",
  "length": 16,
  "entropy_bits": 98.6
}

`lookup_ip`

Look up geolocation and network info for any IPv4 or IPv6 address.

Parameters

Name	Type	Required	Description
`ip`	string	yes	IPv4 or IPv6 address (e.g. `8.8.8.8`)

Response

{
  "ip": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "region": "California",
  "city": "Mountain View",
  "zip": "94043",
  "lat": 37.4056,
  "lon": -122.0775,
  "timezone": "America/Los_Angeles",
  "isp": "Google LLC",
  "org": "Google LLC",
  "asn": "AS15169 Google LLC",
  "is_mobile": false,
  "is_proxy": false,
  "is_hosting": true
}

`check_ssl`

Check SSL/TLS certificate details for any domain.

Parameters

Name	Type	Required	Description
`domain`	string	yes	Domain name (e.g. `example.com`)

Response

{
  "domain": "example.com",
  "valid": true,
  "issuer": "Let's Encrypt",
  "subject": "example.com",
  "san": ["example.com", "www.example.com"],
  "valid_from": "2026-01-01T00:00:00Z",
  "valid_to": "2026-04-01T00:00:00Z",
  "days_remaining": 22,
  "protocol": "TLSv1.3"
}

`lookup_dns`

Query DNS records for a domain. Omit type to get all available record types at once.

Parameters

Name	Type	Required	Default	Description
`domain`	string	yes	—	Domain to query (e.g. `example.com`)
`type`	`"A"` \| `"AAAA"` \| `"MX"` \| `"TXT"` \| `"CNAME"` \| `"NS"` \| `"SOA"`	no	all	Record type

Response

{
  "domain": "example.com",
  "records": {
    "A": ["93.184.216.34"],
    "MX": [{ "exchange": "mail.example.com", "priority": 10 }],
    "NS": ["ns1.example.com", "ns2.example.com"],
    "TXT": ["v=spf1 include:_spf.example.com ~all"]
  },
  "queried_at": "2026-06-09T12:00:00Z"
}

`whois_lookup`

Get domain registration information.

Parameters

Name	Type	Required	Description
`domain`	string	yes	Domain to look up (e.g. `example.com`)

Response

{
  "domain": "example.com",
  "registrar": "Example Registrar, Inc.",
  "registered_at": "1995-08-14T00:00:00Z",
  "expires_at": "2027-08-13T00:00:00Z",
  "updated_at": "2024-08-13T00:00:00Z",
  "nameservers": ["a.iana-servers.net", "b.iana-servers.net"],
  "status": ["clientDeleteProhibited", "clientTransferProhibited"]
}

`compress_pdf`

Reduce PDF file size using Ghostscript compression. Max file size: 4 MB.

Parameters

Name	Type	Required	Default	Description
`file_base64`	string	yes	—	Base64-encoded PDF content
`level`	`"screen"` \| `"ebook"` \| `"printer"` \| `"prepress"`	no	`"ebook"`	Compression level. `screen` = smallest, `prepress` = highest quality

Response

{
  "pdf": "<base64-encoded compressed PDF>",
  "original_size": 2048000,
  "compressed_size": 819200,
  "reduction_percent": 60
}

`merge_pdfs`

Merge 2–20 PDF files into a single document. Max 4 MB per file.

Parameters

Name	Type	Required	Description
`files_base64`	string[]	yes	Array of base64-encoded PDFs to merge in order (2–20 files)

Response

{
  "pdf": "<base64-encoded merged PDF>",
  "page_count": 12,
  "files_merged": 3
}

`split_pdf`

Split a PDF into multiple documents. Max file size: 4 MB.

Parameters

Name	Type	Required	Default	Description
`file_base64`	string	yes	—	Base64-encoded PDF to split
`mode`	`"range"` \| `"every_n"` \| `"every_page"`	yes	—	Split mode
`pages`	string	no	—	Page range when `mode=range`, e.g. `"1-3,5,7-9"`
`every_n`	number	no	—	Split every N pages when `mode=every_n`

Response

{
  "files": [
    "<base64-encoded PDF part 1>",
    "<base64-encoded PDF part 2>"
  ],
  "count": 2
}

`pdf_to_word`

Convert a PDF to an editable Word document (.docx). Max file size: 4 MB.

Parameters

Name	Type	Required	Description
`file_base64`	string	yes	Base64-encoded PDF to convert

Response

{
  "docx": "<base64-encoded .docx file>",
  "page_count": 5
}

`unlock_pdf`

Remove owner-password permission restrictions from a PDF (print lock, copy lock, etc.). Does not require the password if only owner restrictions are set.

Parameters

Name	Type	Required	Description
`file_base64`	string	yes	Base64-encoded PDF
`password`	string	no	PDF password, if the file requires one to open

Response

{
  "pdf": "<base64-encoded unlocked PDF>",
  "was_encrypted": true
}

Authentication

Set your API key as an environment variable:

export PST_API_KEY=pst_live_your_key_here

Or pass it inline for a one-off test:

PST_API_KEY=pst_live_your_key_here node dist/index.js

The key is sent as X-Api-Key: pst_live_... on every request.

Rate limits & plans

Plan	Price	Calls/month
Free	$0	1,500
Starter	$29/mo	15,000
Pro	$99/mo	100,000
Business	Custom	1,000,000+

When you exceed your limit the API returns 429 Too Many Requests. Limits reset on the 1st of each month (UTC).

Get or upgrade your key: https://www.publicsofttools.com/account/api-keys

Troubleshooting

"PST_API_KEY environment variable is required"
The server exits immediately if no key is set. Make sure the env block in your MCP config has PST_API_KEY set.

Tools don't appear in Claude Desktop
Verify the JSON config is valid (no trailing commas), then fully quit and reopen Claude Desktop — a window close isn't enough.

401 Unauthorized
Your API key is invalid or has been revoked. Look it up again at https://www.publicsofttools.com/account/api-keys.

429 Too Many Requests
You've hit your monthly limit. Upgrade your plan or wait for the 1st-of-month reset.

413 File Too Large
PDF endpoints have a 4 MB binary limit. Compress or split the file before sending.

Node version error
Run node --version. You need Node 18 or later for native fetch. Update via https://nodejs.org.

License

MIT — see LICENSE

Available Tools

14 tools

check_sslA

Check SSL/TLS certificate details for any domain: issuer, expiry date, SANs, and days remaining.

Inputs: domain (required).

compress_pdfB

Compress a PDF file to reduce its size. Accepts a base64-encoded PDF, returns a compressed base64 PDF.

Inputs: file_base64 (required), quality.

encode_decode_base64B

Encode text to base64 or decode base64 back to plain text.

Inputs: text (required), action (required), url_safe.

generate_hashA

Generate cryptographic hashes for any text. Returns MD5, SHA-1, SHA-256, SHA-384, and SHA-512 in a single call.

Inputs: text (required).

generate_passwordB

Generate a cryptographically secure random password with configurable rules.

Inputs: length, uppercase, numbers, symbols.

generate_qr_codeB

Generate a QR code image for any text, URL, or data. Returns a base64 PNG or SVG image.

Inputs: text (required), size, format.

generate_uuidA

Generate one or more UUID v4 values.

Inputs: count.

lookup_dnsA

Query DNS records for a domain. Supports A, AAAA, MX, TXT, CNAME, NS, and SOA record types.

Inputs: domain (required), type.

lookup_ipA

Get geolocation, ISP, ASN, and proxy/VPN detection for any IPv4 or IPv6 address.

Inputs: ip (required).

merge_pdfsA

Merge 2–20 PDF files into a single document. Accepts array of base64-encoded PDFs.

Inputs: files_base64 (required).

pdf_to_wordB

Convert a PDF to an editable Word document (.docx). Returns a base64-encoded DOCX file.

Inputs: file_base64 (required).

split_pdfA

Split a PDF by page range or every N pages. Returns array of base64-encoded split PDFs.

Inputs: file_base64 (required), mode (required), pages, every_n.

unlock_pdfA

Remove permission restrictions (owner password) from a PDF. Returns unlocked base64 PDF.

Inputs: file_base64 (required), password.

whois_lookupA

Look up domain registration information: registrar, registrant, creation/expiry dates, and nameservers.

Inputs: domain (required).

Tool Schema Changelog

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

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A3.7/5.0

Scored 2026-06-15 02:40 across 14 tools

Disambiguation5/5

Each tool targets a distinct utility function: SSL checking, PDF manipulation, encoding, hash/password/QR/UUID generation, DNS/IP/WHOIS lookups. No two tools have overlapping purposes, making it easy for an agent to select the correct one.

Naming Consistency3/5

The naming convention is inconsistent: most tools use verb_noun (e.g., compress_pdf, split_pdf), but some use noun_verb (whois_lookup) or double verbs (encode_decode_base64). While readable, the pattern is not uniform.

Tool Count5/5

With 14 tools covering networking, PDF, encoding, and generation utilities, the count feels well-scoped for a general-purpose toolbox. Each tool earns its place without overwhelming the agent.

Completeness4/5

The tool set covers common utility needs like SSL, DNS, WHOIS, hash, password, QR, UUID, and full PDF lifecycle (compress, split, merge, unlock, convert). Minor gaps exist (e.g., no regex, JSON formatting), but the surface is largely complete for its stated purpose.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

vøiddo utilitiesA
com.voiddo.data
26 deterministic tools: PDF, image, QR, CSV/Excel, HTML to PDF, DNS/RDAP, FX rates, time zones.
Developer Tools Image & Video Processing
261
https://data.voiddo.com/mcp/
vøiddo utilitiesA
com.voiddo.data
26 deterministic tools: PDF, image, QR, CSV/Excel, HTML to PDF, DNS/RDAP, FX rates, time zones.
Developer Tools
261
https://data.voiddo.com/mcp
CoreNexis API
com.corenexis
PDF from HTML or Markdown, OCR, email validation, image conversion and hosting, QR and barcodes.
Developer Tools Image & Video Processing
1
https://api.corenexis.com/mcp/server
devtools-mcpA
cn.pianam.mcp
Developer toolkit: UUID, timestamp, unit conversion, JSON tools, and QR code (SVG). Free.
Developer Tools
71
https://mcp.pianam.cn/devtools-mcp/mcp

Related MCP Servers

Kiprio MCP
Developer Tools Web Scraping Text Summarization
ForeverTools
A
license
A
quality
C
maintenance
23 developer & data API tools for AI agents - IP/DNS/WHOIS/SSL lookups, web scraping & screenshots, text AI (summarize, translate, sentiment, grammar, redact), and dev utilities (hash, UUID, QR, JWT, cron, IBAN/VAT/email validation, breach check).
Updated 3 months ago (2026-08-02 14:54 UTC)
23
75 PyPI
MIT
QuickHelp
Developer Tools Image & Video Processing
Jan-Stepien
F
license
Not graded
quality
D
maintenance
free dev tools (JWT, JSON, Base64, image converter, hash, UUID, and more) — each with a UI, REST API, and MCP server. No auth, stateless, <5s.
Updated 4 months ago (2026-07-13 11:25 UTC)
-
obfus.link
Developer Tools Command Line
subether-labs
A
license
Not graded
quality
D
maintenance
Offers 31 deterministic developer tools (obfuscators, encoders, converters, validators) on a lean, machine-payable MCP endpoint.
Updated 5 months ago (2026-06-24 03:38 UTC)
MIT
OpenQRofficial
Marketing
open-qr
A
license
Not graded
quality
B
maintenance
Generate QR codes and create, edit and track dynamic (editable) QR codes with scan analytics, folders, style themes and branded subdomain management. Free REST API with an OpenAPI spec alongside; every tool takes a free API key.
Updated 3 days ago (2026-11-10 15:39 UTC)
15
AGPL 3.0

PublicSoftTools MCP Server

Tools included

Prerequisites

Install & configure

Claude Desktop

Cursor

Windsurf

Tool reference

generate_qr_code

generate_hash

generate_uuid

encode_decode_base64

generate_password

lookup_ip

check_ssl

lookup_dns

whois_lookup

compress_pdf

merge_pdfs

split_pdf

pdf_to_word

unlock_pdf

Authentication

Rate limits & plans

Troubleshooting

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Kiprio MCP

QuickHelp

obfus.link

OpenQRofficial

`generate_qr_code`

`generate_hash`

`generate_uuid`

`encode_decode_base64`

`generate_password`

`lookup_ip`

`check_ssl`

`lookup_dns`

`whois_lookup`

`compress_pdf`

`merge_pdfs`

`split_pdf`

`pdf_to_word`

`unlock_pdf`