Overview
An SSL checker API and certificate verification API for expiry monitoring, domain audits and CI checks: send a hostname, get its live SSL certificate back as JSON. SSL Checker opens a real TLS connection to the site, reads the certificate and the chain the server sends, and validates it the way a client does (trusted root, hostname match, expiry), returning the verifier's error code such as CERT_HAS_EXPIRED or UNABLE_TO_VERIFY_LEAF_SIGNATURE when it fails. Alongside issuer, subject, key type, key size and signature algorithm, it reports the TLS protocol and cipher negotiated, the Strict-Transport-Security policy, OCSP stapling and embedded Certificate Transparency SCTs, plus derived checks: days until expiry, an expiring-soon flag and self-signed detection. To see which TLS versions a server still accepts, pair it with TLS Checker.
Live Test SSL Certificate Check Skill Skill →
The tool
Once your client is connected to the VerveKit server, this appears in its tool list as SSLCertificateCheckSkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.
{
"name": "SSLCertificateCheckSkill",
"arguments": {
"domain": "ebay.com"
}
}You do not name the tool yourself; the model picks it. Asking about ebay.com in the terms this skill covers is enough for it to reach for SSLCertificateCheckSkill on its own — naming it explicitly also works, and is the way to force the call.
Connecting
One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.
{
"mcpServers": {
"vervekit": {
"url": "https://api.vervekit.com/v1/mcp"
}
}
}https://api.vervekit.com/v1/mcpPer-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.
Arguments
These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.
| Argument | Type | Description |
|---|---|---|
domainRequired | string | The domain of the website to check the SSL certificate of domain |
What the model gets back
The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.
{
"status": "ok",
"error": null,
"data": {
"subject": {
"C": "US",
"ST": "California",
"O": "eBay, Inc.",
"CN": "ebay.com"
},
"issuer": {
"C": "GB",
"O": "Sectigo Limited",
"CN": "Sectigo Public Server Authentication CA OV R40"
},
"subjectaltname": "DNS:ebay.com, DNS:befr.ebay.be, DNS:benl.ebay.be, DNS:cafr.ebay.ca, DNS:e-bay.com, DNS:e-bay.it, DNS:ebay.at, DNS:ebay.be, DNS:ebay.ca, DNS:ebay.ch, DNS:ebay.co.nz, DNS:ebay.co.uk, DNS:ebay.com.au, DNS:ebay.com.cn, DNS:ebay.com.hk, DNS:ebay.com.my, DNS:ebay.com.ph, DNS:ebay.com.sg, DNS:ebay.de, DNS:ebay.es, DNS:ebay.fr, DNS:ebay.ie, DNS:ebay.in, DNS:ebay.io, DNS:ebay.it, DNS:ebay.nl, DNS:ebay.ph, DNS:ebay.pl, DNS:ebay.us, DNS:ebay.vn, DNS:shorturiweb.ebay.com, DNS:wwww.ebay.co.uk, DNS:wwww.ebay.com, DNS:wwww.ebay.com.au, DNS:wwww.ebay.de, DNS:wwww.ebay.in, DNS:wwww.ebay.it",
"infoAccess": {
"CA Issuers - URI": [
"http://crt.sectigo.com/SectigoPublicServerAuthenticationCAOVR40.crt"
],
"OCSP - URI": [
"http://ocsp.sectigo.com"
]
},
"ca": false,
"bits": 2048,
"valid_from": "Oct 6 00:00:00 2026 GMT",
"valid_to": "Apr 22 23:59:59 2027 GMT",
"serialNumber": "19FD41E42C169CF248511D2BEE660A83",
"domain": "ebay.com",
"isExpired": false,
"isValid": true,
"daysUntilExpiry": 182,
"isExpiringSoon": false,
"isSelfSigned": false,
"protocol": "TLSv1.3",
"cipher": "TLS_AES_128_GCM_SHA256",
"isTrusted": true,
"trustError": null,
"hostnameMatches": true,
"chain": [
{
"subject": "ebay.com",
"issuer": "Sectigo Public Server Authentication CA OV R40",
"validTo": "Apr 22 23:59:59 2027 GMT",
"isCA": false
},
{
"subject": "Sectigo Public Server Authentication CA OV R40",
"issuer": "Sectigo Public Server Authentication Root R46",
"validTo": "May 13 23:59:59 2040 GMT",
"isCA": true
},
{
"subject": "Sectigo Public Server Authentication Root R46",
"issuer": "USERTrust RSA Certification Authority",
"validTo": "Jan 18 23:59:59 2038 GMT",
"isCA": true
},
{
"subject": "USERTrust RSA Certification Authority",
"issuer": "USERTrust RSA Certification Authority",
"validTo": "Jan 18 23:59:59 2038 GMT",
"isCA": true
}
],
"keyType": "RSA",
"signatureAlgorithm": "sha256WithRSAEncryption",
"hasEmbeddedSCTs": true,
"ocspStapled": true,
"hsts": {
"present": true,
"maxAge": 31536000,
"includeSubDomains": false,
"preload": false
}
}
}
Response fields
Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.
| Field | Type | Example | Description |
|---|---|---|---|
subjectPremium | object | {…} | Certificate subject information including country, state, organization, and common name |
subject.CPremium | string | US | Country code of the certificate subject |
subject.STPremium | string | California | State or province of the certificate subject |
subject.OPremium | string | eBay, Inc. | Organization name of the certificate subject |
subject.CNPremium | string | ebay.com | Common name of the certificate subject domain |
issuerPremium | object | {…} | Certificate issuing authority information including country, organization, and common name |
issuer.CPremium | string | GB | Country code of the certificate issuer |
issuer.OPremium | string | Sectigo Limited | Organization name of the certificate issuing authority |
issuer.CNPremium | string | Sectigo Public Server Authentication CA OV R40 | Common name of the certificate authority |
subjectaltnamePremium | string | DNS:ebay.com, DNS:befr.ebay.be, DNS:benl.ebay.be, DNS:cafr.ebay.ca, DNS:e-bay.com, DNS:e-bay.it, DNS… | Alternative subject names included in the certificate |
infoAccessPremium | object | {…} | Information access extension with CA issuers and OCSP URIs |
infoAccess.CA Issuers - URIPremium | array | ["http://crt.sectigo.com/SectigoPublicServerAuthenticationCAOVR40.crt"] | URLs to CA issuer certificates for validation |
infoAccess.OCSP - URIPremium | array | ["http://ocsp.sectigo.com"] | Online Certificate Status Protocol URLs for validation |
ca | boolean | false | Indicates if certificate is a certificate authority |
bits | number | 2048 | Key size in bits representing certificate strength |
valid_from | string | Oct 6 00:00:00 2026 GMT | Certificate validity start date and time in GMT |
valid_to | string | Apr 22 23:59:59 2027 GMT | Certificate validity end date and time in GMT |
serialNumberPremium | string | 19FD41E42C169CF248511D2BEE660A83 | Unique serial number of the SSL certificate |
domain | string | ebay.com | Domain name the certificate was checked for |
isExpired | boolean | false | Whether the certificate is past its valid_to date |
isValid | boolean | true | Whether the current time is within the certificate's validity window (valid_from to valid_to) |
daysUntilExpiryPremium | number | 182 | Whole days until the certificate expires (negative if already expired) |
isExpiringSoonPremium | boolean | false | Whether the certificate expires within the next 30 days |
isSelfSignedPremium | boolean | false | Whether the certificate is self-signed (subject and issuer are the same entity), which browsers do not trust |
protocol | string | TLSv1.3 | TLS version negotiated for this check, e.g. TLSv1.3 |
cipher | string | TLS_AES_128_GCM_SHA256 | Cipher suite negotiated for this check (IANA name where known, e.g. TLS_AES_128_GCM_SHA256) |
isTrusted | boolean | true | Whether the certificate chain verifies to a trusted root CA (Node.js's bundled Mozilla root store) and is within its validity dates. Hostname matching is reported separately in hostnameMatches. Revocation is not checked |
trustError | object | null | The verifier error code when isTrusted is false, e.g. CERT_HAS_EXPIRED, DEPTH_ZERO_SELF_SIGNED_CERT, SELF_SIGNED_CERT_IN_CHAIN or UNABLE_TO_VERIFY_LEAF_SIGNATURE (usually a missing intermediate); null when trusted |
hostnameMatches | boolean | true | Whether the certificate's subject alternative names (or common name, if it has none) cover the checked domain |
chainPremium | array[4] | The certificate chain from the site certificate upward: what the server sent, plus the trust-store root when one was found | |
chain.0.subjectPremium | string | ebay.com | Common name (or organization) of this certificate |
chain.0.issuerPremium | string | Sectigo Public Server Authentication CA OV R40 | Common name (or organization) of the certificate that signed it |
chain.0.validToPremium | string | Apr 22 23:59:59 2027 GMT | Expiry date and time of this certificate in GMT |
chain.0.isCAPremium | boolean | false | Whether this certificate is a certificate authority |
keyType | string | RSA | Public key algorithm of the certificate: RSA, EC, Ed25519, Ed448, RSA-PSS or DSA |
signatureAlgorithm | string | sha256WithRSAEncryption | Algorithm the issuer signed the certificate with, e.g. sha256WithRSAEncryption or ecdsa-with-SHA256 (dotted OID if unrecognised) |
hasEmbeddedSCTs | boolean | true | Whether the certificate embeds Certificate Transparency SCTs (RFC 6962 extension). SCTs delivered by TLS extension or OCSP instead are not detected |
ocspStapled | boolean | true | Whether the server stapled an OCSP response to the handshake |
hsts | object | {…} | Strict-Transport-Security policy from the response to GET /; null if the server completed the handshake but returned no HTTP response |
hsts.present | boolean | true | Whether the response carried a Strict-Transport-Security header |
hsts.maxAge | number | 31536000 | max-age in seconds (0 means HSTS is switched off); null if absent |
hsts.includeSubDomains | boolean | false | Whether the policy includes the includeSubDomains directive |
hsts.preload | boolean | false | Whether the policy includes the preload directive |
Failure modes
Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.
| Status | What it means |
|---|---|
400 / 422 | The arguments did not validate. The message names the offending one. |
401 | The OAuth session is invalid or expired — reconnect the server. |
403 | Blocked by a key restriction or an IP allow-list. Never a bad identity. |
404 | This skill is not part of VerveKit. Check the catalog. |
429 | Out of credits, or a brief rate limit. The message tells them apart. |
A call costs 10 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.
Use cases
- SSL Monitoring and Expiry Alerts
- DevOps teams check their domains daily from a cron job or uptime monitor, alerting on certificates close to expiry, failed chain validation or a hostname mismatch before browsers start showing warnings.
- Customer Domain Audits
- When clients point custom hostnames to a SaaS platform, automated onboarding scripts verify validity status and key strength before activating traffic.
- Certificate Chain and Key Audits
- Security teams sweep corporate web properties for setups that need fixing: certificates that fail validation, servers missing an intermediate, RSA keys under 2048 bits, SHA-1 signatures or no HSTS policy.
- Partner Domain Verification
- To prevent broken checkouts, e-commerce marketplaces inspect partner payment gateways to confirm validity windows before routing shopper transactions.
Other ways to use SSL Certificate Check Skill
Set up SSL Certificate Check Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.
Related
More in Domain Data: