Skip to main content
Use SSLMate Cert Spotter through Corsair: one client, typed API calls. Create an API key at https://sslmate.com/account/api_keys. The free tier allows 100 single-hostname queries an hour and 10 full-domain queries an hour; paid plans raise both. Things to know:
  • Paging is a cursor. The last issuance’s id is the next call’s after. Repeat until the answer is an empty array: you have caught up. The operation returns only the array, not the provider’s Retry-After header, so wait a few minutes before asking again with the same cursor (Cert Spotter currently asks firehose readers to wait 5 minutes).
  • Fields need expand. dns_names, issuer, revocation, problem_reporting, cert_der and the pubkey fields are left out unless named in expand. A nested field takes a dotted path, such as issuer.caa_domains.
  • revoked is three-state. It is true, false, or null when Cert Spotter cannot determine the status. Expired certificates always report null.
  • Wildcards. A request for www.example.com does not return a *.example.com certificate unless match_wildcards is true, and sub-domain certificates need include_subdomains.
  • The firehose needs its own subscription. firehose.list returns every issuance across all logs. Falling too far behind answers lagging_client, which means restart from the end rather than retry.
  • Two failures are not retried. timeout means the query exceeded your plan’s limit, and payment_required means the subscription lapsed. Both need a plan change, not a replay.
What you get:
  • 2 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

List the certificates for a domain
Write No write-style endpoint inferred; pick any operation from the API reference. See the full list on the API page.

What’s next

API reference

Every certspotter.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.