Agent Plugin
Install the Blindrelay Agent Plugin in any Agent Plugins 1.0 client and sign in when your host asks, or use a scoped API key. The plugin connects to Blindrelay's hosted server for you — there is nothing else to install or run.
Start free Prefer the CLI?Why the Agent Plugin
- Works in any Agent Plugins 1.0 host
- Skills teach when to send, manage domains, and keep content off disk
- Same ops as the CLI — one key surface
Install
Install https://github.com/blindrelay-app/agent-plugin from your client's plugin or connector UI. The same package works in Claude, ChatGPT, Cursor, and other Agent Plugins 1.0 hosts.
Example: in Claude Code, run these two commands, then run /mcp in Claude and sign in.
claude plugin marketplace add blindrelay-app/agent-plugin claude plugin install blindrelay@blindrelay
Example: in Cursor chat, run /add-plugin https://github.com/blindrelay-app/agent-plugin, then Install from Customize.
The plugin offers two ways to connect; turn on only the one you use. Sign in with your Blindrelay account (recommended), or paste a scoped API key from the API Keys (sign-in required) page. If you sign in, keep the API-key connection switched off.
Tools and scopes
| Tool | Scope | Description |
|---|---|---|
setup_status | any | Where setup stands and the next step: domain, DNS records, verification, test send. Resumable; the test email only after you confirm it |
email_check | any | Check subject, HTML and text before sending: placeholder links, unrendered template variables, HTML mistakes. Never fetches links; returns each finding with its severity |
send | send | Queue a transactional email (optional headers such as Reply-To or List-Unsubscribe) |
domains_listdomains_getdomains_dns_guide | read | List or inspect sending domains, or copy an LLM DNS publish prompt |
domains_adddomains_verifydomains_rotate_dkimdomains_remove | write | Register, verify DNS, rotate DKIM, or delete a domain |
domains_set_dedicated_ip | write | Pin a domain to a dedicated IP, force shared, or follow workspace default |
dedicated_ip_get | read | List dedicated IP assignments and workspace default |
dedicated_ip_requestdedicated_ip_canceldedicated_ip_resume_checkoutdedicated_ip_set_defaultdedicated_ip_dismiss_closure | write | Request, pay, cancel, or set default dedicated IP |
inbound_forward_get | read | List inbound forward aliases (paid plans) |
inbound_forward_addinbound_forward_updateinbound_forward_remove | write | Create, update, or delete inbound forward aliases (mailbox or HTTPS endpoint) |
inbound_endpoint_list | read | List inbound HTTPS endpoints with delivery diagnostics (never the signing secret) |
inbound_endpoint_addinbound_endpoint_updateinbound_endpoint_removeinbound_endpoint_rotate_secretinbound_endpoint_test | write | Manage inbound HTTPS endpoints; add and rotate-secret return the signing secret once |
usageusage_history | read | Current and historical usage |
spend_cap_set | write | Set or clear the monthly message cap that limits overage spend |
delivery_stats | read | Delivery counters (optional period, domain, egress filters) |
email_status | send | Delivery status of one message by the id its send returned (a read key works too; no recipient or content) |
email_list | send | Recent messages for the delivery data window: id, domain, status, timestamps (a read key works too; no recipient or content) |
suppression_listsuppression_export | read | List or export suppression hashes (no plaintext addresses) |
suppression_lookup | read | Find every suppression entry for an address, with its cause (matched in process, never stored) |
suppression_add | write | Add a hash-only manual suppression (plaintext hashed in process) |
suppression_remove | write | Remove any suppression entry by id; hard bounces and complaints need an explicit confirmation |
audit_list | read | Control-plane audit events (no message content) |
otlp_get | read | Get OTLP export config (auth header masked) |
otlp_saveotlp_test | write | Save OTLP config or probe the collector |
delivery_settings_get | read | Get delivery webhook settings (auth header masked) and hook diagnostics: attempts, last attempt, HTTP status, failure category |
delivery_settings_savedelivery_settings_test | write | Save delivery webhook settings or send a test webhook (category and HTTP status, not counted). The first save of a webhook returns its signing secret, once |
delivery_settings_rotate_secret | write | Generate or rotate the webhook signing secret, shown once; the replaced secret also signs for 24 hours |
send_feedback | any | Send product feedback to the Blindrelay team: sentiment, area, what worked or did not, and the goal behind it. Agents send it only after you approve the draft; text with an email address is refused |
Same surface as the CLI.
Machine API
Plugin tools wrap /v1/*. For request bodies and error codes, use the API reference.