OpenCode

Prerequisites

• OpenCode installed
• A MailCraft API key with the scopes you want the agent to have — create one under Settings → API keys.

Setup

1. 1

   Set your API key

   Keep the key out of the config file by exporting it from your shell profile (~/.zshrc, ~/.bashrc, …):

   terminal Copy

   export MAILCRAFT_API_KEY="sk_live_your_api_key"

2. 2

   Add the server

   In opencode.json at your project root, or ~/.config/opencode/opencode.json for every project:

   opencode.json Copy

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "mailcraft": {
         "type": "remote",
         "url": "https://mcp.mailcraft.host",
         "headers": {
           "Authorization": "Bearer {env:MAILCRAFT_API_KEY}"
         },
         "enabled": true
       }
     }
   }

3. 3

   Restart OpenCode

   Close and reopen OpenCode to load the configuration.

4. 4

   Verify the connection

   Ask:

   opencode Copy

   List all my MailCraft domains

Example prompts

Once connected, try asking OpenCode:

• Send a test of the "Welcome" template to me
• Which automations are active right now?
• Validate every email address in fixtures/users.json

See every tool the agent can use in the MCP server reference.