Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

SocketLabs (BYOK) — connector documentation

  • MCP endpoint: https://byok-socketlabs.connectorbay.com/mcp
  • REST API: POST https://byok-socketlabs.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-socketlabs.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own SocketLabs SocketLabs API key (created with the 'SocketLabs Api' access option), sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-socketlabs.connectorbay.com/health · Tool schemas: https://byok-socketlabs.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-socketlabs · agent@connectorbay.com

What SocketLabs (BYOK) is for

SocketLabs (BYOK) lets an AI assistant read your own SocketLabs data through the SocketLabs API with a key you supply (SocketLabs API key (created with the 'SocketLabs Api' access option)). Read-only: 12 tools (get_usage_summary, list_sending_domains, list_bounce_domains, list_dkim_entries, list_tracking_domains, get_delivery_overview, get_failures_overview, list_failed_messages, search_messages_by_recipient, search_suppressions, get_streamscore, get_sender_queue_count). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.socketlabs.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by SocketLabs. SocketLabs and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "How many emails have I used so far this billing period on SocketLabs server 12345?"
  • "Which sending domains on SocketLabs server 12345 are authenticated?"
  • "Which bounce domains are set up on SocketLabs server 12345?"
  • "Which DKIM selectors does SocketLabs server 12345 use?"
  • "Is click tracking enabled on SocketLabs server 12345?"
  • "How many emails did SocketLabs server 12345 deliver between 2026-10-01 and 2026-10-07?"

What it does

  • get_usage_summary: Show a server's current billing period, plan name and cost, messages and bandwidth used against the plan allowance.
  • list_sending_domains: List a server's sending domains with verification status, authentication status and StreamScore.
  • list_bounce_domains: List a server's custom bounce domains and which one is the default.
  • list_dkim_entries: List a server's DKIM entries with domain, selector and record type (the private key is shown only in truncated form by the provider and is not returned here).
  • list_tracking_domains: List a server's engagement tracking domains with open, click and unsubscribe tracking switches and encrypted tracking status.
  • get_delivery_overview: Show daily delivery totals for a server over a date range: queued, sent, delivered, opens, clicks, unsubscribes, failures and complaints.
  • get_failures_overview: Show daily failure totals for a server over a date range: hard and soft failures, complaints and suppressed messages.
  • list_failed_messages: List messages that failed to deliver in a date range with recipient, sender, subject, mailing id and the receiving mail server.
  • search_messages_by_recipient: List the messages sent to one recipient address in a date range with delivery status, last event, opens and clicks.
  • search_suppressions: List addresses on a server's suppression list with the reason and last update, sorted by email address by default.
  • get_streamscore: Show a server's StreamScore (sender reputation score) for a day with week-over-week and day-over-day change.
  • get_sender_queue_count: Show how many messages are waiting in a server's sender queue.

BYOK key

You bring your own SocketLabs SocketLabs API key (created with the 'SocketLabs Api' access option) (https://portal.socketlabs.com/x/smtp-api/key-manager). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.socketlabs.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the SocketLabs API (api.socketlabs.com) with a BYOK key; documentation: https://docs.socketlabs.com/. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by SocketLabs. SocketLabs and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your SocketLabs account.

Built for: Worldwide. Languages: English.