Docs/Skills/SSL Certificate Check Skill

SSL Certificate Check Skill

Check SSL certificate

OperationalCredits 10 per callp50 802msDomain Data

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.

Tool call
{
  "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"
    }
  }
}

Per-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.

ArgumentTypeDescription
domainRequiredstringThe 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.

Result
{
  "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.

FieldTypeExampleDescription
subjectPremiumobject{…}Certificate subject information including country, state, organization, and common name
subject.CPremiumstringUSCountry code of the certificate subject
subject.STPremiumstringCaliforniaState or province of the certificate subject
subject.OPremiumstringeBay, Inc.Organization name of the certificate subject
subject.CNPremiumstringebay.comCommon name of the certificate subject domain
issuerPremiumobject{…}Certificate issuing authority information including country, organization, and common name
issuer.CPremiumstringGBCountry code of the certificate issuer
issuer.OPremiumstringSectigo LimitedOrganization name of the certificate issuing authority
issuer.CNPremiumstringSectigo Public Server Authentication CA OV R40Common name of the certificate authority
subjectaltnamePremiumstringDNS: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
infoAccessPremiumobject{…}Information access extension with CA issuers and OCSP URIs
infoAccess.CA Issuers - URIPremiumarray["http://crt.sectigo.com/SectigoPublicServerAuthenticationCAOVR40.crt"]URLs to CA issuer certificates for validation
infoAccess.OCSP - URIPremiumarray["http://ocsp.sectigo.com"]Online Certificate Status Protocol URLs for validation
cabooleanfalseIndicates if certificate is a certificate authority
bitsnumber2048Key size in bits representing certificate strength
valid_fromstringOct 6 00:00:00 2026 GMTCertificate validity start date and time in GMT
valid_tostringApr 22 23:59:59 2027 GMTCertificate validity end date and time in GMT
serialNumberPremiumstring19FD41E42C169CF248511D2BEE660A83Unique serial number of the SSL certificate
domainstringebay.comDomain name the certificate was checked for
isExpiredbooleanfalseWhether the certificate is past its valid_to date
isValidbooleantrueWhether the current time is within the certificate's validity window (valid_from to valid_to)
daysUntilExpiryPremiumnumber182Whole days until the certificate expires (negative if already expired)
isExpiringSoonPremiumbooleanfalseWhether the certificate expires within the next 30 days
isSelfSignedPremiumbooleanfalseWhether the certificate is self-signed (subject and issuer are the same entity), which browsers do not trust
protocolstringTLSv1.3TLS version negotiated for this check, e.g. TLSv1.3
cipherstringTLS_AES_128_GCM_SHA256Cipher suite negotiated for this check (IANA name where known, e.g. TLS_AES_128_GCM_SHA256)
isTrustedbooleantrueWhether 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
trustErrorobjectnullThe 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
hostnameMatchesbooleantrueWhether the certificate's subject alternative names (or common name, if it has none) cover the checked domain
chainPremiumarray[4]The certificate chain from the site certificate upward: what the server sent, plus the trust-store root when one was found
chain.0.subjectPremiumstringebay.comCommon name (or organization) of this certificate
chain.0.issuerPremiumstringSectigo Public Server Authentication CA OV R40Common name (or organization) of the certificate that signed it
chain.0.validToPremiumstringApr 22 23:59:59 2027 GMTExpiry date and time of this certificate in GMT
chain.0.isCAPremiumbooleanfalseWhether this certificate is a certificate authority
keyTypestringRSAPublic key algorithm of the certificate: RSA, EC, Ed25519, Ed448, RSA-PSS or DSA
signatureAlgorithmstringsha256WithRSAEncryptionAlgorithm the issuer signed the certificate with, e.g. sha256WithRSAEncryption or ecdsa-with-SHA256 (dotted OID if unrecognised)
hasEmbeddedSCTsbooleantrueWhether the certificate embeds Certificate Transparency SCTs (RFC 6962 extension). SCTs delivered by TLS extension or OCSP instead are not detected
ocspStapledbooleantrueWhether the server stapled an OCSP response to the handshake
hstsobject{…}Strict-Transport-Security policy from the response to GET /; null if the server completed the handshake but returned no HTTP response
hsts.presentbooleantrueWhether the response carried a Strict-Transport-Security header
hsts.maxAgenumber31536000max-age in seconds (0 means HSTS is switched off); null if absent
hsts.includeSubDomainsbooleanfalseWhether the policy includes the includeSubDomains directive
hsts.preloadbooleanfalseWhether 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.

StatusWhat it means
400 / 422The arguments did not validate. The message names the offending one.
401The OAuth session is invalid or expired — reconnect the server.
403Blocked by a key restriction or an IP allow-list. Never a bad identity.
404This skill is not part of VerveKit. Check the catalog.
429Out 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.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →
Google Sheets or ExcelA =VERVE() formula fills a column — no script, no export, recalculates in place.VerveSheets →Reference →
Ground an agent on itA cited, machine-checkable fact your model can't produce on its own.VerveContext →Reference →

More in Domain Data:

Was this page helpful?