Doorman

Read how Doorman works and how to integrate it (the same text as /llms.txt). Call this first if you haven't used Doorman before.

{
  "type": "object",
  "properties": {}
}

Create a Doorman account for the user with a first form and an API key. Ask the user for their email first. They'll get an email to set a dashboard password. Creates the account's first form too and returns its id and action URL, plus the api_key (store it as DOORMAN_KEY in the project's local secrets file, never commit it). Only for new users: if they already have an account, ask for a key instead. Until the user clicks the confirmation link in that email, nothing is emailed to them (100 checks; Slack and webhooks work).

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The user's email. Real submissions are forwarded here by default."
    },
    "site_url": {
      "type": "string",
      "description": "The website the form is on, e.g. acme.com"
    },
    "site_context": {
      "type": "string",
      "description": "One or two sentences: what the business sells and to whom. Doorman compares every submission against this. Read the project's README/landing copy to write it."
    },
    "form_name": {
      "type": "string",
      "description": "Optional name, e.g. 'Contact form' or 'Demo request'"
    },
    "mode": {
      "type": "string",
      "enum": [
        "watch",
        "enforce"
      ],
      "description": "watch forwards everything and only tags would-be drops. Recommended for a new lead form: switch to enforce after a week or two of verdicts look right. Default enforce."
    }
  },
  "required": [
    "email",
    "site_url",
    "site_context"
  ]
}

Account, plan and this month's usage.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    }
  }
}

List the account's forms with their action URLs and settings.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    }
  }
}

Create another form endpoint (one per distinct form on the site: contact, demo request, checkout, comments).

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    },
    "name": {
      "type": "string",
      "description": "Form name"
    },
    "kind": {
      "type": "string",
      "enum": [
        "lead",
        "signup",
        "checkout",
        "comment"
      ],
      "description": "lead = contact/demo/quote/sales form (default)"
    },
    "site_context": {
      "type": "string",
      "description": "What the business sells and to whom"
    },
    "email_to": {
      "type": "string",
      "description": "Comma-separated emails to forward real submissions to"
    },
    "webhook_url": {
      "type": "string",
      "description": "HTTPS URL that receives a signed JSON POST per real submission"
    },
    "slack_url": {
      "type": "string",
      "description": "Slack incoming webhook URL"
    },
    "redirect_url": {
      "type": "string",
      "description": "Where to send the visitor after submitting (default: a Doorman thank-you page)"
    }
  },
  "required": [
    "name"
  ]
}

Change a form's settings: context, destinations, thresholds, watch mode, allow/block lists.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    },
    "form_id": {
      "type": "string",
      "description": "f_..."
    },
    "name": {
      "type": "string",
      "description": "Form name"
    },
    "kind": {
      "type": "string",
      "enum": [
        "lead",
        "signup",
        "checkout",
        "comment"
      ]
    },
    "site_context": {
      "type": "string",
      "description": "What the business sells and to whom"
    },
    "mode": {
      "type": "string",
      "enum": [
        "enforce",
        "watch"
      ],
      "description": "watch = deliver everything, tag would-be drops (a safe way to start)"
    },
    "deliver_at": {
      "type": "number",
      "description": "Deliver when P(real) >= this (default 0.8)"
    },
    "drop_below": {
      "type": "number",
      "description": "Drop when P(real) < this (default 0.2)"
    },
    "forward_holds": {
      "type": "boolean",
      "description": "Forward held submissions, flagged (default true)"
    },
    "email_to": {
      "type": "string",
      "description": "Comma-separated emails"
    },
    "webhook_url": {
      "type": "string",
      "description": "HTTPS webhook URL"
    },
    "slack_url": {
      "type": "string",
      "description": "Slack incoming webhook URL"
    },
    "redirect_url": {
      "type": "string",
      "description": "Redirect after submit"
    },
    "allow_list": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Emails or domains always delivered without judging"
    },
    "block_list": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Emails or domains always dropped"
    }
  },
  "required": [
    "form_id"
  ]
}

Get ready-to-paste integration code for a form on a given platform. Use 'html' for static sites, 'react' for SPA client components, and 'fetch' (plain fetch with timeout and fallback: Workers, Node, Next, Deno), 'nextjs', 'express', 'python', 'ruby' or 'elixir' when the form already posts to the project's own backend.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    },
    "form_id": {
      "type": "string",
      "description": "f_..."
    },
    "platform": {
      "type": "string",
      "enum": [
        "html",
        "ajax",
        "react",
        "fetch",
        "nextjs",
        "express",
        "curl",
        "python",
        "ruby",
        "elixir",
        "webflow",
        "framer",
        "wordpress"
      ]
    }
  },
  "required": [
    "form_id",
    "platform"
  ]
}

Judge a sample message against a form's settings. Free, not forwarded, not counted. Use it to show the user Doorman working after setup (try one genuine enquiry and one sales pitch).

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    },
    "form_id": {
      "type": "string",
      "description": "f_..."
    },
    "message": {
      "type": "string",
      "description": "The message text"
    },
    "email": {
      "type": "string",
      "description": "Optional sender email"
    }
  },
  "required": [
    "form_id",
    "message"
  ]
}

Send a sample delivery to the form's email/Slack/webhook destinations and report whether each one worked.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    },
    "form_id": {
      "type": "string",
      "description": "f_..."
    }
  },
  "required": [
    "form_id"
  ]
}

Recent submissions with their verdicts. Use review=true for held ones waiting for a human.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    },
    "form_id": {
      "type": "string",
      "description": "Optional f_..."
    },
    "route": {
      "type": "string",
      "enum": [
        "deliver",
        "hold",
        "drop"
      ]
    },
    "review": {
      "type": "boolean"
    },
    "limit": {
      "type": "number"
    }
  }
}

Mark a submission real (delivers it if it was held or dropped) or spam.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    },
    "submission_id": {
      "type": "string",
      "description": "sub_..."
    },
    "label": {
      "type": "string",
      "enum": [
        "real",
        "spam"
      ]
    }
  },
  "required": [
    "submission_id",
    "label"
  ]
}

Stuck, or something isn't working? Send the problem straight to Doorman's founder, with the error you hit. Your account context (plan, forms, recent errors, never keys) is attached, and the reply goes to the account email. Use it instead of guessing at a fix.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
    },
    "message": {
      "type": "string",
      "description": "What you were trying to do and what happened"
    },
    "error": {
      "type": "string",
      "description": "The exact error text, if any"
    },
    "category": {
      "type": "string",
      "enum": [
        "setup",
        "bug",
        "billing",
        "question",
        "other"
      ]
    }
  },
  "required": [
    "message"
  ]
}