cogny cliemailfirst 15 calls free

    get a newsletter scriptable from Bash.

    Manage contacts, lists, drafts and senders, send or schedule newsletters, and pull detailed delivery reports — opens, clicks, bounces and unsubscriptions — from the shell over the Get a Newsletter MCP. No REST client to build.

    • 1. sign up, free for the first calls (uses your git email)npx @cogny/cli init --agent claude-code
    • 2. see every Get a Newsletter toolcogny tools list
    • 3. call any tool from bash, no MCP wiringcogny tools call mcp__Get_a_Newsletter__tool_get_report --input '{…}'
    01two paths
    you're a person

    Today you log into Get a Newsletter, open a sent newsletter, and read its report tab by tab. With the CLI you pull the report and its open/click breakdowns as JSON in one call you can pipe into a spreadsheet or an agent. Connect Get a Newsletter once in Cogny Solo and let your coding agent, or a scheduled loop, do the querying for you.

    Start Solo
    you're an agent

    Sign yourself up with one command. The CLI issues a key, wires nothing, and exposes every Get a Newsletter tool over JSON-RPC. The first 15 calls are free.

    • npx @cogny/cli init --agent claude-code
    02tools call

    real Get a Newsletter tools.

    Tool names as the Get a Newsletter MCP serves them. Send --input JSON, get JSON back. The payloads are illustrative.

    • mcp__Get_a_Newsletter__tool_get_report

      Detailed engagement report for one sent newsletter.

      • cogny tools call mcp__Get_a_Newsletter__tool_get_report \ --input '{"report_id":"48213"}'
      example response
      {
        "report_id": "48213",
        "subject": "Weekly digest #34",
        "sent": 8420,
        "delivered": 8312,
        "opens": 3104,
        "clicks": 488,
        "bounces": 108,
        "unsubscriptions": 21
      }
    • mcp__Get_a_Newsletter__tool_list_lists

      List all contact lists with active subscriber counts.

      • cogny tools call mcp__Get_a_Newsletter__tool_list_lists \ --input '{"page":1}'
      example response
      {
        "count": 2,
        "results": [
          {
            "hash": "a1b2c3",
            "name": "Newsletter",
            "active_subscribers": 8420
          },
          {
            "hash": "d4e5f6",
            "name": "Product updates",
            "active_subscribers": 2110
          }
        ]
      }
    • mcp__Get_a_Newsletter__tool_create_contact

      Add a contact and subscribe it to one or more lists.

      • cogny tools call mcp__Get_a_Newsletter__tool_create_contact \ --input '{"email":"ada@example.com","first_name":"Ada","lists":[{"hash":"a1b2c3"}]}'
      example response
      {
        "email": "ada@example.com",
        "first_name": "Ada",
        "active": 1,
        "lists": [
          {
            "hash": "a1b2c3",
            "name": "Newsletter"
          }
        ]
      }
    03tools list

    the rest of the surface.

    A sample of the other Get a Newsletter tools. Run cogny tools list --json for every tool and its input schema.

    • mcp__Get_a_Newsletter__tool_list_contacts
    • mcp__Get_a_Newsletter__tool_create_list
    • mcp__Get_a_Newsletter__tool_create_draft
    • mcp__Get_a_Newsletter__tool_send_draft
    • mcp__Get_a_Newsletter__tool_list_senders
    • mcp__Get_a_Newsletter__tool_get_report_opens
    • mcp__Get_a_Newsletter__tool_get_report_clicks
    • mcp__Get_a_Newsletter__tool_get_report_unsubscriptions
    04then a verdict

    calls from a script. verdicts from cogny.

    Every write is logged with who authorised it. Launches your agent makes (a new campaign, a new ad) become measured tickets automatically; for other changes, your agent offers to register them. Cogny measures each in your own data, three days later for ads and seven for content and SEO, and closes it as worked, partial, didn't work or inconclusive.

    • worked

      Moved the number. Every measured win has a share card.

    • partial

      Some of it did.

    • didn't work

      On the record anyway, so it isn't proposed again.

    • inconclusive

      Not enough data to call.

    How the loop works

    05questions

    questions.

    Is this an official Get a Newsletter CLI?
    No — it is the Cogny CLI calling the Get a Newsletter MCP over the cogny-mcp-proxy. You connect Get a Newsletter once in Cogny, and then every tool is callable from Bash with your Cogny key.
    Can it send newsletters or only read reports?
    Both. The MCP exposes read tools (contacts, lists, reports, opens/clicks/bounces) and write tools (create and send drafts, schedule sends, manage senders and attributes).
    How are reports structured?
    Each sent newsletter has a report id. `tool_get_report` gives the summary; `tool_get_report_opens`, `tool_get_report_clicks`, `tool_get_report_bounces` and `tool_get_report_unsubscriptions` give the per-recipient breakdowns as JSON.
    06related

    Building an agent? The full tool map for every server is one fetch: /cli/llms.txt

    get a newsletter, then a verdict.