MCP-Tools-Referenz
Durchsuche alle 14 Nomadfiling-MCP-Tools — Filing-CRUD, Partnerschaftseinreichungen, Zahlungen, Faxprotokolle, Formularschema und PDF-URLs — mit Parametern, Antworten und Beispielen.
{
"method": "tools/call",
"params": {
"name": "list_filings",
"arguments": {
"limit": 2
}
}
}
[
{
"id": "f5dbb2d8-118d-4688-97f0-85b2f278d29c",
"llc_name": "Cedar Ridge Imports LLC",
"ein": "98-7654321",
"tax_year_begin": "2025-01-01",
"tax_year_end": "2025-12-31",
"status": "completed",
"created_at": "2026-01-14T18:22:11.302Z"
},
{
"id": "f03c32e7-d6ae-4bbc-a0cb-fcf2107ea6f0",
"llc_name": "North Harbor Trading LLC",
"ein": "81-2233445",
"tax_year_begin": "2024-01-01",
"tax_year_end": "2024-12-31",
"status": "completed",
"created_at": "2025-02-03T09:41:28.901Z"
}
]
{
"method": "tools/call",
"params": {
"name": "get_filing",
"arguments": {
"id": "f5dbb2d8-118d-4688-97f0-85b2f278d29c"
}
}
}
{
"id": "f5dbb2d8-118d-4688-97f0-85b2f278d29c",
"llc_name": "Cedar Ridge Imports LLC",
"ein": "98-7654321",
"tax_year_begin": "2025-01-01",
"tax_year_end": "2025-12-31",
"status": "completed",
"created_at": "2026-01-14T18:22:11.302Z",
"form_data": {
"taxYearBegin": "2025-01-01",
"taxYearEnd": "2025-12-31",
"llcName": "Cedar Ridge Imports LLC",
"llcStreet": "4100 Meridian Ave",
"llcCity": "Miami, FL 33140",
"ein": "98-7654321",
"isInitialYear": true,
"ownerName": "Lucia Ortega",
"ownerCitizenship": "Spain",
"relatedParties": [
{
"id": "rp_1",
"name": "Iberia Holdings SL",
"relationship": "25pct_shareholder"
}
],
"signerTitle": "Managing Member",
"signatureDate": "2026-01-14"
}
}
{
"method": "tools/call",
"params": {
"name": "create_filing",
"arguments": {
"form_data": {
"taxYearBegin": "2025-01-01",
"taxYearEnd": "2025-12-31",
"llcName": "Blue Summit Ventures LLC",
"llcStreet": "88 Market Street",
"llcCity": "San Francisco, CA 94105",
"ein": "83-5566778",
"isInitialYear": false,
"ownerName": "Kenji Watanabe",
"ownerStreet": "2-14-7 Shibuya",
"ownerCity": "Tokyo",
"ownerCitizenship": "Japan",
"relatedParties": []
}
}
}
}
{
"id": "a78f82c4-c6af-43ef-bc0a-cbbd7e28db77",
"view_url": "https://app.nomadfiling.com/filing/a78f82c4-c6af-43ef-bc0a-cbbd7e28db77"
}
{
"method": "tools/call",
"params": {
"name": "update_filing",
"arguments": {
"id": "a78f82c4-c6af-43ef-bc0a-cbbd7e28db77",
"llc_name": "Blue Summit Ventures LLC",
"form_data": {
"taxYearBegin": "2025-01-01",
"taxYearEnd": "2025-12-31",
"llcName": "Blue Summit Ventures LLC",
"ein": "83-5566778",
"signerTitle": "Manager"
}
}
}
}
{
"id": "a78f82c4-c6af-43ef-bc0a-cbbd7e28db77",
"view_url": "https://app.nomadfiling.com/filing/a78f82c4-c6af-43ef-bc0a-cbbd7e28db77"
}
{
"method": "tools/call",
"params": {
"name": "delete_filing",
"arguments": {
"id": "a78f82c4-c6af-43ef-bc0a-cbbd7e28db77"
}
}
}
{
"ok": true
}
{
"method": "tools/call",
"params": {
"name": "list_partnership_filings",
"arguments": {
"limit": 2
}
}
}
[
{
"id": "17a5cb76-e3fe-4a21-b12b-a0a194dfef5a",
"llc_name": "Juniper Atlas Partners LLC",
"ein": "86-4433221",
"tax_year_begin": "2025-01-01",
"tax_year_end": "2025-12-31",
"status": "completed",
"created_at": "2026-02-09T15:08:41.221Z"
}
]
{
"method": "tools/call",
"params": {
"name": "get_partnership_filing",
"arguments": {
"id": "17a5cb76-e3fe-4a21-b12b-a0a194dfef5a"
}
}
}
{
"id": "17a5cb76-e3fe-4a21-b12b-a0a194dfef5a",
"llc_name": "Juniper Atlas Partners LLC",
"ein": "86-4433221",
"tax_year_begin": "2025-01-01",
"tax_year_end": "2025-12-31",
"status": "completed",
"created_at": "2026-02-09T15:08:41.221Z",
"form_data": {
"partnershipName": "Juniper Atlas Partners LLC",
"ein": "86-4433221",
"city": "Austin",
"state": "TX",
"zip": "78701",
"accountingMethod": "cash",
"taxYearBegin": "2025-01-01",
"taxYearEnd": "2025-12-31",
"partners": [
{
"id": "4dbf5ee0-b584-4bc0-8101-2cb423909e3f",
"name": "Mariana Silva",
"type": "general",
"isForeign": true,
"entityType": "individual",
"withholdingRate": "37"
}
]
}
}
{
"method": "tools/call",
"params": {
"name": "create_partnership_filing",
"arguments": {
"form_data": {
"partnershipName": "Summit Oak Advisory LLC",
"ein": "92-6677880",
"street": "1550 Blake Street",
"city": "Denver",
"state": "CO",
"zip": "80202",
"businessActivity": "Management consulting",
"businessActivityCode": "541611",
"dateBusinessStarted": "2025-01-15",
"accountingMethod": "cash",
"totalAssets": "25000",
"taxYearBegin": "2025-01-01",
"taxYearEnd": "2025-12-31",
"partners": []
}
}
}
}
{
"id": "4fe24805-f32a-4c80-ab95-e408819802f4",
"view_url": "https://app.nomadfiling.com/partnership"
}
{
"method": "tools/call",
"params": {
"name": "update_partnership_filing",
"arguments": {
"id": "4fe24805-f32a-4c80-ab95-e408819802f4",
"form_data": {
"partnershipName": "Summit Oak Advisory LLC",
"ein": "92-6677880",
"street": "1550 Blake Street",
"city": "Denver",
"state": "CO",
"zip": "80202",
"businessActivity": "Management consulting",
"businessActivityCode": "541611",
"dateBusinessStarted": "2025-01-15",
"accountingMethod": "cash",
"totalAssets": "42000",
"taxYearBegin": "2025-01-01",
"taxYearEnd": "2025-12-31",
"partners": []
}
}
}
}
{
"ok": true
}
{
"method": "tools/call",
"params": {
"name": "delete_partnership_filing",
"arguments": {
"id": "4fe24805-f32a-4c80-ab95-e408819802f4"
}
}
}
{
"ok": true
}
{
"method": "tools/call",
"params": {
"name": "list_payments",
"arguments": {}
}
}
[
{
"id": "pay_01JY6Y8KQ4ZC8W7PZ4M2J4BN0N",
"amount": 299,
"currency": "usd",
"status": "succeeded",
"filings_purchased": 1,
"created_at": "2026-01-02T11:15:09.104Z"
}
]
{
"method": "tools/call",
"params": {
"name": "list_fax_logs",
"arguments": {}
}
}
[
{
"id": "fax_01JY6YFRGQ2KQ2H29M3X6X8T8D",
"to_number": "+12125550199",
"from_number": "+16465550101",
"status": "delivered",
"pages_sent": 6,
"created_at": "2026-01-20T16:32:50.002Z",
"completed_at": "2026-01-20T16:35:17.447Z",
"failure_reason": null
}
]
{
"method": "tools/call",
"params": {
"name": "get_form_schema",
"arguments": {
"kind": "5472"
}
}
}
{
"description": "Field descriptions for the Form 5472 and Form 1120 workflow",
"fields": {
"taxYearBegin": "Tax year start date",
"taxYearEnd": "Tax year end date",
"llcName": "Legal name of the LLC",
"llcStreet": "Street address of the LLC",
"llcCity": "City, state, and ZIP for the LLC",
"ein": "Employer Identification Number",
"totalAssets": "Total assets at year end",
"businessActivity": "Primary business activity",
"businessActivityCode": "Business activity code",
"relatedParties": "Array of related party objects"
}
}
{
"method": "tools/call",
"params": {
"name": "get_pdf_url",
"arguments": {
"id": "f5dbb2d8-118d-4688-97f0-85b2f278d29c"
}
}
}
{
"url": "https://app.nomadfiling.com/filing/f5dbb2d8-118d-4688-97f0-85b2f278d29c",
"kind": "5472"
}
Nomadfiling-Tools über deinen MCP-Client verwenden
Nomadfiling stellt 14 authentifizierte MCP-Tools bereit, um Einreichungen aufzulisten, zu erstellen, zu aktualisieren und zu löschen, plus Zahlungsverlauf, Faxprotokolle, Formularschemas und PDF-Deep-Links. Nutze diese Seite als Referenz für Tool-Namen, Eingaben, Antwortformen und gängige Anfragemuster.
Jeder Tool-Aufruf erfordert Authentifizierung über deinen MCP-Client. Richte deine Anmeldedaten ein, bevor du ein Tool aufrufst.
Tools aus deinem Client aufrufen
Die meisten MCP-Clients verpacken Tool-Aufrufe unterschiedlich, aber die Nutzlastform ist gleich: übergib den Tool-Namen und ein JSON-Objekt mit den Tool-Argumenten.
{
"method": "tools/call",
"params": {
"name": "list_filings",
"arguments": {
"limit": 10
}
}
}
curl -X POST "https://mcp.nomadfiling.com" \
-H "Authorization: Bearer sk_test_example_9xmk7q2r" \
-H "Content-Type: application/json" \
-d '{
"method": "tools/call",
"params": {
"name": "list_filings",
"arguments": {
"limit": 10
}
}
}'
Eine erfolgreiche Antwort enthält das in den folgenden Abschnitten definierte Tool-Ergebnis. Tools, die eine bestimmte Einreichung nachschlagen oder ändern, geben einen Fehler zurück, wenn die Einreichung nicht existiert oder nicht dem authentifizierten Nutzer gehört.
5472- und 1120-Einreichungstools
Diese Tools arbeiten mit Einreichungsdatensätzen für Einzelmitglieds-Workflows zu Form 5472 und Form 1120.
list_filings
Listet 5472- und 1120-Einreichungen auf, die dem authentifizierten Nutzer gehören.
Maximale Anzahl zurückzugebender Einreichungen. Standard ist 50.
Antwort
Das Tool gibt ein Array von Einreichungsübersichtsobjekten zurück.
Eindeutige Einreichungskennung als UUID.
Auf dem Einreichungsdatensatz gespeicherter LLC-Name.
Employer Identification Number der Einreichung.
Auf der Einreichung gespeichertes Startdatum des Steuerjahres.
Auf der Einreichung gespeichertes Enddatum des Steuerjahres.
Aktueller Einreichungsstatus.
Zeitstempel, wann die Einreichung erstellt wurde.
Beispiel
get_filing
Ruft die vollständigen Daten einer einzelnen 5472- und 1120-Einreichung ab.
Einreichungs-UUID.
Antwort
Das Tool gibt die vollständige Einreichungszeile zurück, einschließlich des serialisierten Objekts form_data, das zum Befüllen der Einreichung verwendet wird.
Eindeutige Einreichungskennung.
LLC-Name der Einreichung.
Employer Identification Number.
Startdatum des Steuerjahres.
Enddatum des Steuerjahres.
Aktueller Einreichungsstatus.
Erstellungszeitstempel.
Vollständige Formularnutzlast der Einreichung, einschließlich Gesellschaft, Eigentümer, verbundener Partei, Transaktion, Unterschrift und optionaler Dokumentdaten.
Beispiel
get_filing gibt einen Fehler mit der Meldung Filing not found zurück, wenn die Einreichung nicht existiert oder nicht dem authentifizierten Nutzer gehört.
create_filing
Erstellt einen neuen 5472- und 1120-Einreichungsdatensatz.
Vollständige Einreichungsnutzlast. Dieses Objekt enthält die Formularwerte, die von der Nomadfiling-App verwendet werden.
Auf der Einreichungszeile gespeicherter LLC-Name. Wenn weggelassen, fällt das Tool auf form_data.llcName zurück.
Auf der Einreichungszeile gespeicherte Employer Identification Number. Wenn weggelassen, fällt das Tool auf form_data.ein zurück.
Auf der Einreichungszeile zu speicherndes Startdatum des Steuerjahres.
Auf der Einreichungszeile zu speicherndes Enddatum des Steuerjahres.
Antwort
Das Tool erstellt die Einreichung mit Status completed und gibt die neue Einreichungskennung und App-URL zurück.
Neue Einreichungs-UUID.
App-URL zum Öffnen der Einreichung.
Beispiel
update_filing
Aktualisiert eine bestehende 5472- und 1120-Einreichung. Nur die von dir angegebenen Felder werden aktualisiert.
Einreichungs-UUID.
Aktualisierter LLC-Name.
Aktualisierte Employer Identification Number.
Aktualisiertes Startdatum des Steuerjahres.
Aktualisiertes Enddatum des Steuerjahres.
Aktualisierte Formularnutzlast. Das Tool patcht nur die angegebenen Felder auf Zeilenebene der Einreichung.
Antwort
Aktualisierte Einreichungs-UUID.
App-URL zum Öffnen der aktualisierten Einreichung.
Beispiel
update_filing gibt Filing not found zurück, wenn die Einreichung nicht existiert oder der authentifizierte Nutzer sie nicht aktualisieren darf.
delete_filing
Löscht eine 5472- und 1120-Einreichung.
Einreichungs-UUID.
Antwort
Gibt true zurück, wenn die Einreichung gelöscht wurde.
Beispiel
Partnerschafts-Einreichungstools
Diese Tools arbeiten mit Partnerschaftseinreichungen für Multi-Member-LLCs, einschließlich Form 1065, Schedule K-1 sowie den Workflows zu Form 8804 und 8805.
list_partnership_filings
Listet Partnerschaftseinreichungen auf, die dem authentifizierten Nutzer gehören.
Maximale Anzahl zurückzugebender Einreichungen. Standard ist 50.
Antwort
Das Tool gibt ein Array von Partnerschafts-Einreichungsübersichten in derselben Form wie list_filings zurück.
Eindeutige Einreichungskennung als UUID.
Auf der Einreichungszeile gespeicherter Partnerschaftsname.
Employer Identification Number.
Startdatum des Steuerjahres.
Enddatum des Steuerjahres.
Aktueller Einreichungsstatus.
Erstellungszeitstempel.
Beispiel
get_partnership_filing
Ruft die vollständigen Daten einer Partnerschaftseinreichung ab.
UUID der Partnerschaftseinreichung.
Antwort
Das Tool gibt die vollständige Einreichungszeile zurück, einschließlich des serialisierten Objekts form_data.
Eindeutige Einreichungskennung.
Auf der Einreichungszeile gespeicherter Partnerschaftsname.
Employer Identification Number.
Startdatum des Steuerjahres.
Enddatum des Steuerjahres.
Aktueller Einreichungsstatus.
Erstellungszeitstempel.
Vollständige Partnerschafts-Formularnutzlast, einschließlich Partnerdaten, Einkommen, Abzügen, Schedule K und Quellensteuerwerten.
Beispiel
get_partnership_filing gibt Filing not found zurück, wenn die Einreichung nicht existiert oder nicht dem authentifizierten Nutzer gehört.
create_partnership_filing
Erstellt eine neue Partnerschaftseinreichung.
Vollständige Nutzlast der Partnerschaftseinreichung. Das Tool leitet llc_name von form_data.partnershipName ab.
Antwort
Das Tool erstellt die Einreichung mit Status completed.
Neue UUID der Partnerschaftseinreichung.
App-URL für den Partnerschafts-Workflow.
Beispiel
update_partnership_filing
Aktualisiert eine bestehende Partnerschaftseinreichung.
UUID der Partnerschaftseinreichung.
Aktualisierte Nutzlast der Partnerschaftseinreichung. Abgeleitete Zeilenfelder werden aus diesem Objekt neu berechnet.
Antwort
Gibt true zurück, wenn die Partnerschaftseinreichung aktualisiert wurde.
Beispiel
delete_partnership_filing
Löscht eine Partnerschaftseinreichung.
UUID der Partnerschaftseinreichung.
Antwort
Gibt true zurück, wenn die Partnerschaftseinreichung gelöscht wurde.
Beispiel
Konto- und Hilfs-Tools
Diese Tools stellen Zahlungen, Faxverlauf, Schema-Metadaten und PDF-URLs bereit.
list_payments
Listet bis zu 100 Zahlungsdatensätze für den authentifizierten Nutzer auf.
Antwort
Zahlungskennung.
Zahlungsbetrag.
Währungscode der Zahlung.
Zahlungsstatus.
Anzahl der gekauften Einreichungen oder Guthaben.
Erstellungszeitstempel.
Beispiel
list_fax_logs
Listet bis zu 100 Faxprotokolldatensätze für den authentifizierten Nutzer auf.
Antwort
Kennung des Faxprotokolls.
Empfänger-Faxnummer.
Absender-Faxnummer.
Faxzustellstatus.
Anzahl der gesendeten Seiten.
Erstellungszeitstempel.
Abschlusszeitstempel, wenn das Fax die Verarbeitung beendet hat.
Fehlergrund, wenn die Zustellung nicht erfolgreich abgeschlossen wird.
Beispiel
get_form_schema
Gibt das unterstützte Formularfeldschema entweder für den 5472- und 1120-Workflow oder den Partnerschafts-Workflow zurück.
Antwort
Das Tool gibt einen Schema-Deskriptor mit einer Beschreibung auf oberster Ebene und einem Objekt fields zurück.
Menschenlesbare Beschreibung des ausgewählten Formularschemas.
Zuordnung unterstützter Feldnamen zu Feldbeschreibungen für die ausgewählte Einreichungsart.
Enthaltene 5472-Felder
Das Schema 5472 enthält diese Felder auf oberster Ebene: taxYearBegin, taxYearEnd, llcName, llcStreet, llcCity, ein, totalAssets, businessActivity, businessActivityCode, isInitialYear, countryIncorporation, dateIncorporation, taxResidentCountry, principalBusinessCountries, ownerName, ownerStreet, ownerCity, ownerUSId, ownerRefId, ownerFTIN, ownerBusinessCountries, ownerCitizenship, ownerTaxResidentCountry, relatedParties, signerTitle, signatureDate, generateForm7004 und generateLateFilingLetter.
Enthaltene Partnerschaftsfelder
Das Schema partnership enthält diese Felder auf oberster Ebene: partnershipName, ein, street, city, state, zip, businessActivity, businessActivityCode, dateBusinessStarted, accountingMethod, totalAssets, taxYearBegin, taxYearEnd, partners, income, deductions, scheduleK und withholding.
Beispiel
get_pdf_url
Gibt einen Deep-Link zur Nomadfiling-App zurück, unter dem die Einreichung geöffnet und PDFs angesehen oder heruntergeladen werden können.
Einreichungs-UUID.
Hinweis zum Einreichungstyp. Standard ist 5472. Das Tool erkennt die korrekte Einreichungstabelle automatisch, bevor es die URL zurückgibt.
5472partnershipAntwort
Deep-Link zur Einreichung in der Nomadfiling-App.
Aufgelöste Einreichungsart, entweder 5472 oder partnership.
Beispiel
Gängige Muster
Verwende dieselbe Einreichungs-id über die Lookup-, Update-, Delete- und PDF-URL-Tools. Erstellungstools geben die id zurück, die du für spätere Operationen benötigst.
{
"create_filing_result": {
"id": "a78f82c4-c6af-43ef-bc0a-cbbd7e28db77",
"view_url": "https://app.nomadfiling.com/filing/a78f82c4-c6af-43ef-bc0a-cbbd7e28db77"
},
"next_call": {
"method": "tools/call",
"params": {
"name": "get_filing",
"arguments": {
"id": "a78f82c4-c6af-43ef-bc0a-cbbd7e28db77"
}
}
}
}
{
"method": "tools/call",
"params": {
"name": "get_pdf_url",
"arguments": {
"id": "17a5cb76-e3fe-4a21-b12b-a0a194dfef5a",
"kind": "partnership"
}
}
}
Wenn du Einreichungsnutzlasten außerhalb der Nomadfiling-App erzeugst, rufe zuerst get_form_schema auf, um die erwarteten Feldnamen auf oberster Ebene für den Einreichungstyp zu prüfen, den du erstellen möchtest.
Verwandte Seiten
FAQ
Ja. Jedes Nomadfiling-MCP-Tool wird über tools/call aufgerufen und erfordert eine authentifizierte MCP-Client-Sitzung.