Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Form Agent Pro

✓ vom Dienst · formagent.pro

von MichaelC1999Version 1.0.0i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registrypro.formagent/form-agent

So installierst du es

What it does

Green card / permanent residency forms (I-485, I-130, I-864, I-765) filled out from your documents.

  • Connects Läuft in der Cloud
  • Account or key Sign in to the service when you connect (OAuth)
  • Category Dokumente, Tabellen & Büroarbeit

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

von opendatalab★ 83.9191 Skills

Skill · AnleitungKeine Lizenz angegeben

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

von guillaumemeyer★ 27.7231 Skills

Skill · Anleitung

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

von kepano★ 53.104 (whole repo)5 Skills

Skill · Anleitung

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-11-18

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte Form Agent Pro. Folge https://mcp.popnx.com/i/pro-formagent-form-agent.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (immi-server-i5sok.ondigitalocean.app) · ✓ Befehle geprüft am 18. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameForm Agent Pro
    Remote MCP server URL · Adressehttps://immi-server-i5sok.ondigitalocean.app/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsForm Agent Pro

  4. Ausprobieren

    Nutze Form Agent Pro und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Form Agent Pro nutzt, oder ein Werkzeug von Form Agent Pro in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameForm Agent Pro
    Connection · Adressehttps://immi-server-i5sok.ondigitalocean.app/mcp
  3. Form Agent Pro im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen Form Agent Pro aus deinen Plugins wählen

  4. Ausprobieren

    Nutze Form Agent Pro und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es Form Agent Pro nutzt, oder ein Werkzeug von Form Agent Pro in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user form-agent https://immi-server-i5sok.ondigitalocean.app/mcp
  3. /mcp in Claude Code eingeben

    Form Agent Pro sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze Form Agent Pro und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es Form Agent Pro nutzt, oder ein Werkzeug von Form Agent Pro in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Form Agent Pro und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es Form Agent Pro nutzt, oder ein Werkzeug von Form Agent Pro in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze Form Agent Pro und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es Form Agent Pro nutzt, oder ein Werkzeug von Form Agent Pro in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://immi-server-i5sok.ondigitalocean.app/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Form Agent Pro nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user form-agent https://immi-server-i5sok.ondigitalocean.app/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "form-agent": {
      "url": "https://immi-server-i5sok.ondigitalocean.app/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "form-agent": {
      "type": "http",
      "url": "https://immi-server-i5sok.ondigitalocean.app/mcp"
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ formagent.pro
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
1.0.0
In der Registry veröffentlichti
18. Nov. 2026
Code zuletzt geänderti
18. Nov. 2026
Zuletzt geprüft
18. Nov. 2026
Entwickler
MichaelC1999
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain formagent.pro bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 22 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/pro-formagent-form-agent.svg)](https://mcp.popnx.com/en/servers/pro-formagent-form-agent)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Dokumente, Tabellen & Büroarbeiti

  • Mehr Sterne als 0 % der anderen 4126 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 94 % der anderen 4126 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 4126 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Form Agent Pro sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (1.0.0) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

von HeyPuterWeit verbreitet★ 44.205Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

von getsentryWeit verbreitet↓ 130.486/Wo. geteiltes Paket★ 6588Aktualisiert vor 4 Monaten

Läuft auf deinem Computer✓ vom Dienst · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

von Vexa-aiWeit verbreitet★ 2994Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · vexa.ai

Atlassian Rovo MCP Server

Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.

von atlassianWachsend★ 1174Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · atlassian.com

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

von ankimcpWachsend↓ 1136/Wo.★ 567Aktualisiert letzten Monat

Läuft auf deinem Computer✓ vom Dienst · ankimcp.ai
Im Vergleich mit ähnlichen
Dieser
Form Agent Pro
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiert
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinJaNein
Basisprüfungen5/54/43/32/44/43/3
LizenzMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

immi-server

Node.js / TypeScript server that automates filling USCIS immigration forms. Anthropic is used for semantic understanding; all PDF I/O is handled by pdftk.


Use it from an AI app (MCP)

Form Agent Pro is a remote Model Context Protocol server. Any MCP client that supports remote servers with OAuth (Claude, ChatGPT, Cursor, VS Code, …) can connect to:

https://immi-server-i5sok.ondigitalocean.app/mcp

Registry name: pro.formagent/form-agent (see server.json).

Sign-in. On first connect the app opens a browser window to sign in with Google. No API key is needed. Your forms are tied to your Google account, the same as on formagent.pro.

Pricing. Browsing and checking progress are free. Preparing a case is paid per case: the first build_situation_context call returns a Stripe checkout link, and the price is shown there. Inference costs are covered by the service.

Tools
ToolCostWhat it does
list_supported_formsFreeLists the immigration processes and USCIS forms supported.
build_situation_contextPaidTakes the user's situation, goal and documents (base64; up to 20 files, 5 MB each, 7 MB total), works out the required forms and starts filling them. Returns a checkout link first, then a situationalContextId once paid.
get_situation_statusFreeProgress for each required form: ready, pending, failed or not generated.
get_filled_pdfFree15-minute download links for each ready form and one merged PDF.

Typical flow: list_supported_forms → build_situation_context (pay) → build_situation_context again with stripeSessionId → poll get_situation_status → get_filled_pdf.

How it is protected
  • OAuth 2.1: dynamic client registration and PKCE. immi-server is its own authorization server and uses Google for the login itself. Discovery is at /.well-known/oauth-protected-resource/mcp.
  • Paid tools: these require a paid, single-use Stripe Checkout session.
  • Limits: per-account and per-IP rate limits, plus per-user and service-wide daily spend caps.
  • Documents: uploads are deleted from the server as soon as their text has been extracted. Download links expire after 15 minutes.
Publishing to the MCP Registry

server.json is the registry entry. Publish it with mcp-publisher. The pro.formagent/ namespace is verified through a DNS TXT record on formagent.pro:

mcp-publisher login dns --domain formagent.pro --private-key <key>

mcp-publisher validate mcp-publisher publish

Bump version in server.json (and SERVER_INFO in src/mcp/server.ts) for each release.


Pipeline

[One-time, per form]

buildFormMap ──→ buildFormContext │ [One-time, per user] │ buildSituationContext ───┘ │ [Once per form × user] ↓ fillFormMap │ ↓ fillForm ──→ filled PDF


Mechanisms

1 — Build Form Map

Route: POST /api/form-map/build File: src/services/buildFormMap.ts AI: None

Extracts every fillable field ID from a blank PDF and persists an empty { " ": "" } map to MongoDB as a FormMap document. Uses a four-strategy waterfall (pdftk → pdf-lib → qpdf → raw-scan) stopping at the first that returns fields. pdftk is preferred because it reliably accesses XFA field definitions that pdf-lib cannot see.

Input: formId, blank PDF (upload or server path), optional version Output: FormMap — { formId, version, fields: Record }

npx ts-node src/services/buildFormMap.ts <formId> <pdfPath> [version]

2 — Build Form Context

Route: POST /api/form-context/build File: src/services/buildFormContext.ts AI: claude-opus-5-5 (streamed), up to 128 000 tokens

Annotates every field in the FormMap with rich metadata using the form's full narrative PDF text and pdftk-extracted per-field alt-text (USCIS-authored descriptions). Produces a FormContext document in MongoDB. Run once per form; thoroughness over speed.

Requires: FormMap already in MongoDB for formId.

Input: formId, blank PDF path, optional supplemental reference files Output: FormContext — { formId, formMetadata, fields: [{ field, description, party, notes }] }

npx ts-node src/services/buildFormContext.ts <formId> <pdfPath> [contextFiles...]

Print prompts only — no Anthropic call, no DB write

PRINT_PROMPT=1 npx ts-node src/services/buildFormContext.ts


3 — Build Situational Context

Route: POST /api/situation/build File: src/services/buildSituationContext.ts AI: claude-opus-5-5 (streamed), up to 128 000 tokens

Accepts a user's immigration situation description and supporting documents. Documents are pre-processed without the LLM (PDFs via pdf-parse, images via Tesseract OCR with eng+por, plain text via fs.readFileSync) to extract raw text cheaply before it is passed to Anthropic. The model produces two outputs: a plain-English situationSummary and a structured partyData map of named parties to key→value fact bags. All output is in English; dates are normalized to ISO 8601; proper nouns are preserved as written in source documents.

Input: userId, situationDescription, processDescription, optional additionalNotes, optional document uploads Output: SituationalContext — { userId, situationSummary, partyData, documents }


4 — Fill Form Map

Route: POST /api/filled-map/fill File: src/services/fillFormMap.ts AI: claude-sonnet-4-5, up to 16 000 tokens

Takes the FormContext and SituationalContext and calls Anthropic to produce a best-effort value for every field on the form. Behaviour is controlled by assumptionLevel:

LevelBehaviour
conservative (default)Only fills fields with an explicit answer in context. Blank if any inference is required.
moderateAdds simple single-step inferences (e.g. nationality from passport country).
liberalFills as many fields as possible; outputs "N/A" / "None" for inapplicable fields. Requires careful review.

Requires: FormContext and SituationalContext already in MongoDB.

Input: formId, userId, situationalContextId, optional assumptionLevel Output: FilledFormMap — { formId, userId, assumptionLevel, fields: Record }

npx ts-node src/services/fillFormMap.ts <formId> <userId> <situationalContextId> [assumptionLevel]

5 — Fill Form

Route: POST /api/form-fill/fill File: src/services/fillForm.ts AI: None

Reads a FilledFormMap from MongoDB and stamps its values into a blank PDF using pdftk. Zero AI involvement — pure deterministic PDF writing. Designed to be extended to additional form types via the IFormFiller interface + getFormFiller() factory; only PDF is implemented today.

Pre-processing applied to every text field before the PDF layer:

  1. NFC normalisation (sanitizeTextValue) — collapses decomposed Unicode sequences (e.g. a + combining-tilde) into precomposed codepoints (ã).
  2. Word-wrap (prepareTextValue, 45-char threshold) — inserts newlines at word boundaries for values that would overflow a field's visible area.

FDF encoding (encodeFdfValue in pdf.ts): Pure ASCII values use the compact () FDF literal. Values containing any non-ASCII character are encoded as UTF-16 BE hex strings prefixed with the Unicode BOM (FEFF), per PDF spec §7.3.4. This prevents pdftk from misreading UTF-8 multi-byte sequences as Latin-1 (the classic São Paulo → São Paulo mojibake).

Output filename: {userId}-{formId}-{mmddyyyy hhmm}.pdf Default output directory: output/ /

Requires: FilledFormMap already in MongoDB.

Input: formId, userId, filledFormMapId, formPdfPath, optional outputDir, optional formType (default "pdf") Output: { success, outputPath, filledFields, skippedFields, errors }

npx ts-node src/services/fillForm.ts <formId> <filledFormMapId> <formPdfPath> [outputDir] [formType]

Example

npx ts-node src/services/fillForm.ts i-130 68a1b2c3d4e5f600 assets/forms/i-130/blank.pdf


6 — Manual Load (utility)

File: src/services/manualLoad.ts AI: None

CLI-only utility for seeding or replacing MongoDB documents directly from JSON files. Useful for testing and for injecting manually prepared data without going through the full pipeline.

Supported collections: form-map, form-context, situational-context, filled-form-map JSON source files live in assets/manual-loads/.

npx ts-node src/services/manualLoad.ts <collection> <file>

Examples

npx ts-node src/services/manualLoad.ts form-map i-130-map.json npx ts-node src/services/manualLoad.ts form-context i-130-context.json npx ts-node src/services/manualLoad.ts situational-context user-context.json npx ts-node src/services/manualLoad.ts filled-form-map user-i130-filled.json



End-to-End Pipeline

POST /api/pipeline/run

File: src/routes/pipeline.ts

Chains all three per-user/per-form steps into a single call: buildSituationContext → fillFormMap (×N) → fillForm (×N). The pipeline derives blank PDF paths automatically from assets/forms/ /blank.pdf, validates they exist before making any AI calls, and continues to the next form if one fails.

Body (multipart/form-data):

FieldTypeRequiredDescription
userIdstring✅Applicant identifier
situationDescriptionstring✅Free-text description of the immigration situation
processDescriptionstring✅Which process/forms the user is pursuing
additionalNotesstring❌Any extra context
formIdsstring✅JSON array or comma-separated — e.g. "i-130,i-485"
assumptionLevelstring❌conservative (default) \moderate \liberal
documentsFile[]❌Up to 20 supporting documents (PDFs, images, text)

Response (200):

{

"situationalContextId": "...", "forms": [ { "formId": "i-130", "filledFormMapId": "...", "success": true, "outputPath": "output/i-130/user_abc-i-130-02272026 1430.pdf", "filledFields": [...], "skippedFields": [...], "errors": [] } ] }


Form Setup (one-time, per form)

File: src/scripts/setup-form.ts

CLI that runs buildFormMap then buildFormContext in sequence for a new form. Run this once per form before using the pipeline.

npx ts-node src/scripts/setup-form.ts <formId> <pdfPath> [version] [contextFiles...]

Examples

npx ts-node src/scripts/setup-form.ts i-485 assets/forms/i-485/blank.pdf npx ts-node src/scripts/setup-form.ts i-693 assets/forms/i-693/blank.pdf 1.0 assets/context/i-693-instructions.md

Requires MONGODB_URI and ANTHROPIC_API_KEY in .env.


Blank Form Assets

Blank PDFs live at assets/forms/ /blank.pdf. Currently available:

assets/forms/

├── g-325a/blank.pdf ├── i-130/blank.pdf ├── i-130a/blank.pdf ├── i-131/blank.pdf ├── i-485/blank.pdf ├── i-693/blank.pdf ├── i-765/blank.pdf └── i-864/blank.pdf

Pass the path directly to any service that accepts formPdfPath.


Environment

MONGODB_URI=...

ANTHROPIC_API_KEY=... # required for buildFormContext, buildSituationContext, fillFormMap PORT=3001 # optional, defaults to 3001

Dependencies

  • pdftk-java — field extraction, FDF generation, form filling (brew install pdftk-java)
  • qpdf — fallback field extraction strategy (`br

Nur der Anfang wird gezeigt; den Rest findest du im Repo