FCCS MCP Agentic Server

Instructions

Implementation Reference

• fccs_agent/tools/data.py:21-35 (handler)

  The main handler function for the 'export_data_slice' tool. It takes a grid definition and optional cube name, calls the underlying FCCS client to export the data slice, and returns the result wrapped in a success status.
  async def export_data_slice( grid_definition: dict[str, Any], cube_name: str = "Consol" ) -> dict[str, Any]: """Export a specific data slice (grid) from the application / Exportar um slice de dados. Args: grid_definition: The data grid definition with pov, columns, and rows. cube_name: The name of the cube (default: 'Consol'). Returns: dict: The exported data slice with rows and column values. """ result = await _client.export_data_slice(_app_name, cube_name, grid_definition) return {"status": "success", "data": result}
• fccs_agent/tools/data.py:274-291 (schema)

  The input schema definition for the 'export_data_slice' tool, specifying the expected parameters: grid_definition (required) and optional cube_name.
  { "name": "export_data_slice", "description": "Export a specific data slice (grid) from the application / Exportar um slice de dados", "inputSchema": { "type": "object", "properties": { "cube_name": { "type": "string", "description": "The name of the cube (default: 'Consol')", }, "grid_definition": { "type": "object", "description": "The data grid definition with pov, columns, and rows", }, }, "required": ["grid_definition"], }, },
• fccs_agent/agent.py:138-185 (registration)

  The TOOL_HANDLERS dictionary in the agent registers 'export_data_slice' by mapping the tool name to its handler function data.export_data_slice. This is used by the execute_tool function to dispatch calls.
  TOOL_HANDLERS = { # Application "get_application_info": application.get_application_info, "get_rest_api_version": application.get_rest_api_version, # Jobs "list_jobs": jobs.list_jobs, "get_job_status": jobs.get_job_status, "run_business_rule": jobs.run_business_rule, "run_data_rule": jobs.run_data_rule, # Dimensions "get_dimensions": dimensions.get_dimensions, "get_members": dimensions.get_members, "get_dimension_hierarchy": dimensions.get_dimension_hierarchy, # Journals "get_journals": journals.get_journals, "get_journal_details": journals.get_journal_details, "perform_journal_action": journals.perform_journal_action, "update_journal_period": journals.update_journal_period, "export_journals": journals.export_journals, "import_journals": journals.import_journals, # Data "export_data_slice": data.export_data_slice, "smart_retrieve": data.smart_retrieve, "smart_retrieve_consolidation_breakdown": data.smart_retrieve_consolidation_breakdown, "smart_retrieve_with_movement": data.smart_retrieve_with_movement, "copy_data": data.copy_data, "clear_data": data.clear_data, # Reports "generate_report": reports.generate_report, "get_report_job_status": reports.get_report_job_status, "generate_report_script": reports.generate_report_script, # Consolidation "export_consolidation_rulesets": consolidation.export_consolidation_rulesets, "import_consolidation_rulesets": consolidation.import_consolidation_rulesets, "validate_metadata": consolidation.validate_metadata, "generate_intercompany_matching_report": consolidation.generate_intercompany_matching_report, "import_supplementation_data": consolidation.import_supplementation_data, "deploy_form_template": consolidation.deploy_form_template, "generate_consolidation_process_report": consolidation.generate_consolidation_process_report, # Memo "generate_system_pitch": memo.generate_system_pitch, "generate_investment_memo": memo.generate_investment_memo, # Feedback "submit_feedback": feedback.submit_feedback, "get_recent_executions": feedback.get_recent_executions, # Local Data "query_local_metadata": local_data.query_local_metadata, }