Doorman
Spam, pitch and fraud screening for website forms. Sign up, wire forms, test and review.
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'doorman_label_submission' description lacks action verbin doorman_label_submission
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"doorman": {
"url": "https://withdoorman.com/mcp"
}
}
}Remote endpoints
https://withdoorman.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🟢doorman_docs
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.
Input Schema
{
"type": "object",
"properties": {}
}🟡doorman_signup(email, site_url, site_context, form_name, mode)
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).
Input Schema
{
"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"
]
}🟢doorman_whoami(api_key)
Account, plan and this month's usage.
Input Schema
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
}
}
}🟢doorman_list_forms(api_key)
List the account's forms with their action URLs and settings.
Input Schema
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "Doorman API key (dm_live_...). Only needed if the MCP connection has no Authorization header."
}
}
}🟡doorman_create_form(api_key, name, kind, site_context, email_to, ...)
Create another form endpoint (one per distinct form on the site: contact, demo request, checkout, comments).
Input Schema
{
"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"
]
}🟡doorman_update_form(api_key, form_id, name, kind, site_context, ...)
Change a form's settings: context, destinations, thresholds, watch mode, allow/block lists.
Input Schema
{
"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"
]
}🟢doorman_get_install_snippet(api_key, form_id, platform)
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.
Input Schema
{
"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"
]
}🟢doorman_test_submission(api_key, form_id, message, email)
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).
Input Schema
{
"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"
]
}🟡doorman_send_test_delivery(api_key, form_id)
Send a sample delivery to the form's email/Slack/webhook destinations and report whether each one worked.
Input Schema
{
"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"
]
}🟢doorman_list_submissions(api_key, form_id, route, review, limit)
Recent submissions with their verdicts. Use review=true for held ones waiting for a human.
Input Schema
{
"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"
}
}
}⚪doorman_label_submission(api_key, submission_id, label)
Mark a submission real (delivers it if it was held or dropped) or spam.
Input Schema
{
"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"
]
}🟡doorman_contact_support(api_key, message, error, category)
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.
Input Schema
{
"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"
]
}Community
Evidence