Discovery for AI agents

FormPass includes machine-readable endpoints and HTML markers so agents can discover and use forms with minimal custom logic.

HTML detection markers

FormPass-enabled pages include meta tags in the <head> that agents can scan for:

<meta name="formpass-form-id" content="FORM_ID">
<meta name="formpass-host" content="https://form-pass.com">

Forms may also carry a data attribute on the form element itself:

<form data-formpass-id="FORM_ID">

FormPass-hosted forms at /f/{formId} include these markers automatically. Self-hosted form owners add them manually via the Connect Your Form tab in their dashboard.

GET /formpass.json

Root discovery metadata for agents and tools.

{
  "formpass": true,
  "version": "1",
  "discovery": "https://your-host/api/forms/{formId}/schema",
  "submit": "https://your-host/api/submit/{formId}",
  "docs": "https://your-host/docs",
  "agentIntegrationGuide": "https://your-host/docs/agent-integration",
  "detection": {
    "metaTag": "formpass-form-id",
    "dataAttribute": "data-formpass-id"
  }
}

GET /llms.txt

Compact, text-first documentation map for LLMs and agent frameworks.

Recommended agent flow

Scan page HTML for <meta name="formpass-form-id"> to detect FormPass forms.
Extract the formId and formpass-host from the meta tags.
Fetch form schema from /api/forms/{formId}/schema.
Build payload from required fields.
Submit to /api/submit/{formId} with optional Agent ID.

For a complete integration guide with code examples, see the Agent integration guide.