Skip to content

[directmailamerica] Add DirectMailAmerica plugin - #649

Open
blockrushusa wants to merge 3 commits into
cursor:mainfrom
blockrushusa:add-directmailamerica
Open

blockrushusa wants to merge 3 commits into
cursor:mainfrom
blockrushusa:add-directmailamerica

Conversation

@blockrushusa

@blockrushusa blockrushusa commented Oct 16, 2026 •

Copy link
Copy Markdown

Adds a directmailamerica plugin that connects to DirectMailAmerica's official hosted MCP server. The server is built and run by Rainmaker LLC d/b/a DirectMailAmerica.com.

What's included

  • third_party/directmailamerica/mcp.json: HTTP server at https://directmailamerica.com/api/mcp, with Authorization: Bearer ${DIRECTMAILAMERICA_API_KEY}
  • plugin.json (1.0.0, cursor 3.13.0) with a required DIRECTMAILAMERICA_API_KEY variable, plus a README, CHANGELOG, MIT LICENSE and a 256x256 logo (DirectMailAmerica's official mark)
  • Three skills under skills/: dma-send-mail, dma-email-to-letter and dma-order-status, each with a name that matches its directory
  • A marketplace entry appended last, with the same description as plugin.json, and a row in the root README table

Auth

The user supplies a workspace API key, created at directmailamerica.com under Developers, and the plugin sends it as a Bearer header. No key is included in the plugin. lbl_test_ keys never buy postage.

Safety

Mailing prints and sends real USPS mail and spends money. Every skill tells the agent not to call send_letter, send_product_quote or approve_email_letter until the user has explicitly approved the exact preview, the addresses and the price, and to ask again if anything changes. Email to Letter rules default to approval mode, and automatic sending needs the user's explicit consent. The status skill is read-only.

Validation

node scripts/validate-plugins.mjs passes.

Contact

Rainmaker LLC d/b/a DirectMailAmerica.com, support@directmailamerica.com, https://directmailamerica.com/agents


Note

Medium Risk
New third-party MCP can trigger real postage charges; mitigated by skill-level approval gates and user-supplied API keys, but agent misuse or weak consent could still spend account balance.

Overview
Adds a new directmailamerica third-party Cursor plugin so agents can quote, send, and track physical USPS mail via DirectMailAmerica’s hosted HTTP MCP at https://directmailamerica.com/api/mcp.

The plugin ships manifest (plugin.json 1.0.0, required DIRECTMAILAMERICA_API_KEY Bearer auth), mcp.json, README/CHANGELOG/MIT license, and three skills (dma-send-mail, dma-email-to-letter, dma-order-status) that require explicit user approval before any paid send or Email-to-Letter approval. Marketplace marketplace.json and the root README plugin table are updated to list the integration.

Reviewed by Cursor Bugbot for commit ecece67. Bugbot is set up for automated code reviews on this repo. Configure here.

…ectmailamerica

# Conflicts:
#	.cursor-plugin/marketplace.json
#	README.md
# Conflicts:
#	.cursor-plugin/marketplace.json
#	README.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant