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.
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.
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.
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.
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.