get_xcom_entries
Retrieve cross-communication data entries between Airflow tasks to monitor and debug workflow execution, supporting filtering by DAG, run, task, and key parameters.
Instructions
Get all XCom entries
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dag_id | Yes | ||
| dag_run_id | Yes | ||
| task_id | Yes | ||
| map_index | No | ||
| xcom_key | No | ||
| limit | No | ||
| offset | No |
Implementation Reference
- src/airflow/xcom.py:19-41 (handler)The handler function implementing the logic for the 'get_xcom_entries' tool. It constructs parameters and calls the Airflow XComApi to fetch entries, returning them as MCP TextContent.
async def get_xcom_entries( dag_id: str, dag_run_id: str, task_id: str, map_index: Optional[int] = None, xcom_key: Optional[str] = None, limit: Optional[int] = None, offset: Optional[int] = None, ) -> List[Union[types.TextContent, types.ImageContent, types.EmbeddedResource]]: # Build parameters dictionary kwargs: Dict[str, Any] = {} if map_index is not None: kwargs["map_index"] = map_index if xcom_key is not None: kwargs["xcom_key"] = xcom_key if limit is not None: kwargs["limit"] = limit if offset is not None: kwargs["offset"] = offset response = xcom_api.get_xcom_entries(dag_id=dag_id, dag_run_id=dag_run_id, task_id=task_id, **kwargs) return [types.TextContent(type="text", text=str(response.to_dict()))] - src/airflow/xcom.py:11-16 (registration)Module-level registration of the 'get_xcom_entries' tool via the get_all_functions() which provides the function, name, description, and read-only flag.
def get_all_functions() -> list[tuple[Callable, str, str, bool]]: """Return list of (function, name, description, is_read_only) tuples for registration.""" return [ (get_xcom_entries, "get_xcom_entries", "Get all XCom entries", True), (get_xcom_entry, "get_xcom_entry", "Get an XCom entry", True), ] - src/main.py:95-96 (registration)Global tool registration loop in main.py that adds the 'get_xcom_entries' handler (imported via get_xcom_functions) to the MCP app using fastmcp Tool.from_function.
for func, name, description, *_ in functions: app.add_tool(Tool.from_function(func, name=name, description=description))