Skip to content
TaxComposer

MeF filing guides

Build a MeF preparation workflow with API and MCP

MeF preparation is form-specific. Start by discovering the installed mapping and validation support; a broad educational form library is not a substitute for those capabilities.

By TaxComposer · Updated · 2 min read

Discover the mapping before sending values

Use taxcomposer_return_catalog to inspect the installed MeF entries and blockers. Then use taxcomposer_return_mef_schema with the form and year to retrieve the mapped fields and exact document and mapping hashes. An unmapped form must remain blocked.

The current contract reports production_submission_allowed:false and sandbox_transmission_available:false for MeF. Do not hide those flags behind a generic “ready to file” state.

Source: TaxComposer MCP connections ↗

Save a mapped draft with source evidence

The hosted taxcomposer_return_mef_prepare tool accepts input and a stable idempotency_key. The input includes form, tax_year, expected_revision:0, document_sha256, mapping_sha256, title, fields and sources. Use the exact discovered mapping and authorized source values.

The corresponding REST operation is POST /v1/returns/mef/prepare under the current API contract. Endpoint access and environment availability must be checked before an integration offers it.

Source: TaxComposer API Documentation ↗

Resume and change the exact draft

Use taxcomposer_return_mef_get to retrieve the saved draft reference, revision, hashes and field counts. Its summary keeps private values server-side. For a correction, use taxcomposer_return_mef_update with the exact draft_id, revision, confirmed targeted changes and idempotency key.

MeF changes use the document’s field mapping, not IRIS JSON-pointer paths. Preserve untouched private data and reload after a revision conflict rather than overwriting the entire record.

Source: TaxComposer API Documentation ↗

Report validation limits honestly

taxcomposer_return_mef_validate uses the installed validation adapter for the saved revision. Missing adapters or mappings stay blocked, and schema validation remains distinct from complete IRS business-rule clearance.

The tool named taxcomposer_return_mef_submit_sandbox currently returns a blocked result because no qualified MeF simulation/transmission adapter is installed. It does not provide an IRS acknowledgment or a successful MeF simulation receipt. Check the MeF form and connection capabilities for available submission actions.

Source: TaxComposer MCP connections ↗

Primary sources

Sources checked November 12, 2026. Use the instructions for your reporting year and circumstances.

Your next step

Build a reviewed return workflow.

Check the form’s current preparation and validation availability in the API documentation. TaxComposer’s IRIS e-filing is production-ready. For MeF returns, check the form’s current preparation, validation and transmission capabilities.

API Documentation →

TaxComposer is production-ready for IRS IRIS e-filing. Prepare for free and pay $1 per form when you file.