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 |

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