MCP ServerMCP Tools Reference

MCP tools reference

Browse all 14 Nomadfiling MCP tools — filing CRUD, partnership filings, payments, fax logs, form schema, and PDF URLs — with parameters, responses, and examples.

{
  "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"
}

Use Nomadfiling tools through your MCP client

Nomadfiling exposes 14 authenticated MCP tools for listing, creating, updating, and deleting filings, plus payment history, fax logs, form schemas, and PDF deep links. Use this page as the reference for tool names, inputs, response shapes, and common request patterns.

Every tool call requires authentication through your MCP client. Set up your credentials before calling any tool.

Authentication

Create API keys

MCP overview

Form guides

Call tools from your client

Most MCP clients wrap tool calls differently, but the payload shape is the same: pass the tool name and a JSON object containing the tool arguments.

{
  "method": "tools/call",
  "params": {
    "name": "list_filings",
    "arguments": {
      "limit": 10
    }
  }
}

A successful response contains the tool result defined in each section below. Tools that look up or mutate a specific filing return an error when the filing does not exist or does not belong to the authenticated user.

5472 and 1120 filing tools

These tools work with single-member filing records for Form 5472 and Form 1120 workflows.

list_filings

List 5472 and 1120 filings owned by the authenticated user.

limitnumber

Maximum number of filings to return. Defaults to 50.

Response

The tool returns an array of filing summary objects.

idstring
Required

Unique filing identifier as a UUID.

llc_namestring
Required

LLC name stored on the filing record.

einstring
Required

Employer Identification Number for the filing.

tax_year_beginstring
Required

Tax year start date stored on the filing.

tax_year_endstring
Required

Tax year end date stored on the filing.

statusstring
Required

Current filing status.

created_atstring
Required

Timestamp when the filing was created.

Example

get_filing

Get the full data for a single 5472 and 1120 filing.

idstring
Required

Filing UUID.

Response

The tool returns the full filing row, including the serialized form_data object used to populate the filing.

idstring
Required

Unique filing identifier.

llc_namestring
Required

LLC name for the filing.

einstring
Required

Employer Identification Number.

tax_year_beginstring
Required

Tax year start date.

tax_year_endstring
Required

Tax year end date.

statusstring
Required

Current filing status.

created_atstring
Required

Creation timestamp.

form_dataobject
Required

Complete form payload for the filing, including entity, owner, related party, transaction, signature, and optional-document data.

Example

get_filing returns an error with the message Filing not found when the filing does not exist or is not owned by the authenticated user.

create_filing

Create a new 5472 and 1120 filing record.

form_dataobject
Required

Complete filing payload. This object contains the form values used by the Nomadfiling app.

llc_namestring

LLC name stored on the filing row. If omitted, the tool falls back to form_data.llcName.

einstring

Employer Identification Number stored on the filing row. If omitted, the tool falls back to form_data.ein.

tax_year_beginstring

Tax year start date to store on the filing row.

tax_year_endstring

Tax year end date to store on the filing row.

Response

The tool creates the filing with status completed and returns the new filing identifier and app URL.

idstring
Required

New filing UUID.

view_urlstring
Required

App URL for opening the filing.

Example

update_filing

Update an existing 5472 and 1120 filing. Only fields you provide are updated.

idstring
Required

Filing UUID.

llc_namestring

Updated LLC name.

einstring

Updated Employer Identification Number.

tax_year_beginstring

Updated tax year start date.

tax_year_endstring

Updated tax year end date.

form_dataobject

Updated form payload. The tool patches only the provided fields at the filing row level.

Response

idstring
Required

Updated filing UUID.

view_urlstring
Required

App URL for opening the updated filing.

Example

update_filing returns Filing not found when the filing does not exist or the authenticated user is not allowed to update it.

delete_filing

Delete a 5472 and 1120 filing.

idstring
Required

Filing UUID.

Response

okboolean
Required

Returns true when the filing is deleted.

Example

Partnership filing tools

These tools work with multi-member LLC partnership filings, including Form 1065, Schedule K-1, and Forms 8804 and 8805 workflows.

list_partnership_filings

List partnership filings owned by the authenticated user.

limitnumber

Maximum number of filings to return. Defaults to 50.

Response

The tool returns an array of partnership filing summaries with the same shape as list_filings.

idstring
Required

Unique filing identifier as a UUID.

llc_namestring
Required

Partnership name stored on the filing row.

einstring
Required

Employer Identification Number.

tax_year_beginstring
Required

Tax year start date.

tax_year_endstring
Required

Tax year end date.

statusstring
Required

Current filing status.

created_atstring
Required

Creation timestamp.

Example

get_partnership_filing

Get the full data for a partnership filing.

idstring
Required

Partnership filing UUID.

Response

The tool returns the full filing row, including the serialized form_data object.

idstring
Required

Unique filing identifier.

llc_namestring
Required

Partnership name stored on the filing row.

einstring
Required

Employer Identification Number.

tax_year_beginstring
Required

Tax year start date.

tax_year_endstring
Required

Tax year end date.

statusstring
Required

Current filing status.

created_atstring
Required

Creation timestamp.

form_dataobject
Required

Complete partnership form payload, including partner data, income, deductions, Schedule K, and withholding values.

Example

get_partnership_filing returns Filing not found when the filing does not exist or is not owned by the authenticated user.

create_partnership_filing

Create a new partnership filing.

form_dataobject
Required

Complete partnership filing payload. The tool derives llc_name from form_data.partnershipName.

Response

The tool creates the filing with status completed.

idstring
Required

New partnership filing UUID.

view_urlstring
Required

App URL for the partnership workflow.

Example

update_partnership_filing

Update an existing partnership filing.

idstring
Required

Partnership filing UUID.

form_dataobject
Required

Updated partnership filing payload. Derived row fields are recalculated from this object.

Response

okboolean
Required

Returns true when the partnership filing is updated.

Example

delete_partnership_filing

Delete a partnership filing.

idstring
Required

Partnership filing UUID.

Response

okboolean
Required

Returns true when the partnership filing is deleted.

Example

Account and utility tools

These tools expose payments, fax history, schema metadata, and PDF URLs.

list_payments

List up to 100 payment records for the authenticated user.

Response

idstring
Required

Payment identifier.

amountnumber
Required

Payment amount.

currencystring
Required

Payment currency code.

statusstring
Required

Payment status.

filings_purchasednumber
Required

Number of filings or credits purchased.

created_atstring
Required

Creation timestamp.

Example

list_fax_logs

List up to 100 fax log records for the authenticated user.

Response

idstring
Required

Fax log identifier.

to_numberstring
Required

Recipient fax number.

from_numberstring
Required

Sender fax number.

statusstring
Required

Fax delivery status.

pages_sentnumber
Required

Number of pages sent.

created_atstring
Required

Creation timestamp.

completed_atstring

Completion timestamp if the fax finished processing.

failure_reasonstring

Reason for failure when delivery does not complete successfully.

Example

get_form_schema

Return the supported form field schema for either the 5472 and 1120 workflow or the partnership workflow.

kindstring
Required

Select which schema to return.

Allowed values:5472partnership

Response

The tool returns a schema descriptor with a top-level description and a fields object.

descriptionstring
Required

Human-readable description of the selected form schema.

fieldsobject
Required

Map of supported field names to field descriptions for the selected filing kind.

5472 fields included

The 5472 schema includes these top-level fields: 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, and generateLateFilingLetter.

Partnership fields included

The partnership schema includes these top-level fields: partnershipName, ein, street, city, state, zip, businessActivity, businessActivityCode, dateBusinessStarted, accountingMethod, totalAssets, taxYearBegin, taxYearEnd, partners, income, deductions, scheduleK, and withholding.

Example

get_pdf_url

Return a deep link to the Nomadfiling app where the filing can be opened and PDFs can be previewed or downloaded.

idstring
Required

Filing UUID.

kindstring

Filing type hint. Defaults to 5472. The tool auto-detects the correct filing table before returning the URL.

Allowed values:5472partnership

Response

urlstring
Required

Deep link to the filing in the Nomadfiling app.

kindstring
Required

Resolved filing kind, either 5472 or partnership.

Example

Common patterns

Use the same filing id across the lookup, update, delete, and PDF URL tools. Creation tools return the id you need for later operations.

{
  "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"
      }
    }
  }
}

If you are generating filing payloads outside the Nomadfiling app, call get_form_schema first to inspect the expected top-level field names for the filing type you want to create.

MCP overview

Authenticate API requests

Form 5472 and 1120

Partnership filing

FAQ

Yes. Every Nomadfiling MCP tool is called through tools/call and requires an authenticated MCP client session.

Was this page helpful?