<?xml version="1.0" encoding="UTF-8"?>
<agent-document format="zappian-agent-view" version="1" kind="forms" path="/forms/newsletter/">
  <title>Newsletter</title>
  <summary>Subscribe an email address to the Zappian Media newsletter: news, stories and insights by email. The form is on the blog and beside each article.</summary>
  <urls human="https://staging.zappian.in/agent/forms/newsletter/" agent="https://staging.zappian.in/agent/forms/newsletter/" markdown="https://staging.zappian.in/agent/forms/newsletter.md" json="https://staging.zappian.in/agent/forms/newsletter.json">
    <formats md="https://staging.zappian.in/agent/forms/newsletter.md" json="https://staging.zappian.in/agent/forms/newsletter.json" xml="https://staging.zappian.in/agent/forms/newsletter.xml" toon="https://staging.zappian.in/agent/forms/newsletter.toon"/>
  </urls>
  <generated>2026-11-19T10:48:48Z</generated>
  <forms>
    <form-ref id="newsletter" title="Newsletter"/>
  </forms>
  <sections>
    <section id="form" title="About this form">
      <facts>
        <fact term="Form id">newsletter</fact>
        <fact term="Purpose">Subscribe an email address to the Zappian Media newsletter: news, stories and insights by email. The form is on the blog and beside each article.</fact>
        <fact term="On these pages"><link href="https://staging.zappian.in/blog/">https://staging.zappian.in/blog/</link></fact>
        <fact term="Where a person fills it in"><link href="https://staging.zappian.in/blog/">https://staging.zappian.in/blog/</link></fact>
        <fact term="Can an agent send it">Not at the moment: this site has switched off sending by agents. A person completes this form on the site. check_form still works.</fact>
      </facts>
    </section>
    <section id="fields" title="Fields">
      <table>
        <head><cell>Field</cell><cell>Type</cell><cell>Required</cell><cell>Limits</cell><cell>Allowed values</cell><cell>What it is</cell></head>
        <row><cell>email</cell><cell>text</cell><cell>yes</cell><cell>up to 254 characters; an email address</cell><cell/><cell>The email address to subscribe. It must be your user's own address.</cell></row>
        <row><cell>_hp</cell><cell>text</cell><cell>no</cell><cell>up to 200 characters</cell><cell/><cell>Leave this out. No person fills it in on the site, and a submission that fills it in is refused.</cell></row>
      </table>
    </section>
    <section id="consent" title="Consent">
      <quote>We're committed to your privacy. Zappian uses the information you provide to us to contact you about our relevant content, products, and services. You may unsubscribe from these communications at any time. For more information, check out our privacy policy.</quote>
      <facts>
        <fact term="Version">c-c1cf6d03be3659a7</fact>
        <fact term="Privacy policy"><link href="https://staging.zappian.in/privacy-policy/">https://staging.zappian.in/privacy-policy/</link></fact>
      </facts>
      <paragraph>Send the version back as consent.version, with a consent.statement saying that your user asked for this submission and agreed to this text.</paragraph>
    </section>
    <section id="sending" title="How to send it">
      <list ordered="true">
        <item>On the MCP server at https://staging.zappian.in/mcp, call check_form with form_id and fields. Nothing is stored or sent. Correct what it lists under problems.</item>
        <item>Then call submit_form with the same fields, consent, operator and an idempotency_key.</item>
      </list>
      <table>
        <head><cell>Argument of submit_form</cell><cell>Example value</cell></head>
        <row><cell>form_id</cell><cell>newsletter</cell></row>
        <row><cell>fields.email</cell><cell>sample.person@example.com</cell></row>
        <row><cell>consent.version</cell><cell>c-c1cf6d03be3659a7</cell></row>
        <row><cell>consent.statement</cell><cell>My user asked me to send this form for them and agreed to the consent text of this version.</cell></row>
        <row><cell>operator.agent_name</cell><cell>Example Assistant</cell></row>
        <row><cell>operator.operator_name</cell><cell>Example Operator Ltd</cell></row>
        <row><cell>operator.operator_contact</cell><cell>agent-operator@example.com</cell></row>
        <row><cell>idempotency_key</cell><cell>newsletter-2026-01-15-0001</cell></row>
      </table>
      <note>Every value in the example is made up. Replace each one with what your user gave you.</note>
    </section>
  </sections>
  <form>
    <string name="id">newsletter</string>
    <string name="title">Newsletter</string>
    <string name="purpose">Subscribe an email address to the Zappian Media newsletter: news, stories and insights by email. The form is on the blog and beside each article.</string>
    <array name="pages">
      <string>https://staging.zappian.in/blog/</string>
    </array>
    <string name="human_url">https://staging.zappian.in/blog/</string>
    <string name="agent_submission">not_available</string>
    <object name="input_schema">
      <string name="$schema">https://json-schema.org/draft/2020-12/schema</string>
      <string name="type">object</string>
      <object name="properties">
        <object name="email">
          <string name="type">string</string>
          <number name="maxLength">254</number>
          <string name="format">email</string>
          <string name="pattern">^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$</string>
          <string name="description">The email address to subscribe. It must be your user's own address.</string>
        </object>
        <object name="_hp">
          <string name="description">Leave this out. No person fills it in on the site, and a submission that fills it in is refused.</string>
          <string name="type">string</string>
          <number name="maxLength">200</number>
        </object>
      </object>
      <array name="required">
        <string>email</string>
      </array>
      <boolean name="additionalProperties">false</boolean>
    </object>
    <object name="consent">
      <string name="text">We're committed to your privacy. Zappian uses the information you provide to us to contact you about our relevant content, products, and services. You may unsubscribe from these communications at any time. For more information, check out our privacy policy.</string>
      <string name="version">c-c1cf6d03be3659a7</string>
      <string name="privacy_url">https://staging.zappian.in/privacy-policy/</string>
    </object>
    <boolean name="operator_required">true</boolean>
  </form>
</agent-document>
