FCCS MCP Agentic Server

Instructions

Implementation Reference

• fccs_agent/tools/consolidation.py:36-48 (handler)

  The main MCP tool handler function that executes the import_consolidation_rulesets logic by delegating to the FCCS client.

  async def import_consolidation_rulesets(
      parameters: Optional[dict[str, Any]] = None
  ) -> dict[str, Any]:
      """Import configurable consolidation rulesets / Importar regras de consolidacao.
  
      Args:
          parameters: Import parameters.
  
      Returns:
          dict: Job submission result.
      """
      result = await _client.import_consolidation_rulesets(_app_name, parameters)
      return {"status": "success", "data": result}

• fccs_agent/tools/consolidation.py:162-174 (schema)

  The input schema definition for the import_consolidation_rulesets tool within the TOOL_DEFINITIONS list.

  {
      "name": "import_consolidation_rulesets",
      "description": "Import configurable consolidation rulesets / Importar regras de consolidacao",
      "inputSchema": {
          "type": "object",
          "properties": {
              "parameters": {
                  "type": "object",
                  "description": "Import parameters",
              },
          },
      },
  },

• fccs_agent/agent.py:170-176 (registration)

  Registration of consolidation tools, including import_consolidation_rulesets, in the central TOOL_HANDLERS dictionary.

  "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,

• fccs_agent/agent.py:188-199 (registration)

  Aggregation of all tool definitions including consolidation.TOOL_DEFINITIONS which contains the schema for import_consolidation_rulesets.

  ALL_TOOL_DEFINITIONS = (
      application.TOOL_DEFINITIONS +
      jobs.TOOL_DEFINITIONS +
      dimensions.TOOL_DEFINITIONS +
      journals.TOOL_DEFINITIONS +
      data.TOOL_DEFINITIONS +
      reports.TOOL_DEFINITIONS +
      consolidation.TOOL_DEFINITIONS +
      memo.TOOL_DEFINITIONS +
      feedback.TOOL_DEFINITIONS +
      local_data.TOOL_DEFINITIONS
  )

• fccs_agent/client/fccs_client.py:610-624 (helper)

  The underlying FCCSClient method called by the tool handler to perform the actual HTTP POST request for importing rulesets.

  async def import_consolidation_rulesets(
      self,
      app_name: str,
      parameters: Optional[dict[str, Any]] = None
  ) -> dict[str, Any]:
      """Import consolidation rulesets / Importar regras de consolidacao."""
      if self.config.fccs_mock_mode:
          return {"jobId": "302", "status": "Submitted", "jobType": "ImportRulesets"}
  
      response = await self._client.post(
          f"/{app_name}/importConfigConsolRules{self._get_query_params()}",
          json=parameters or {}
      )
      response.raise_for_status()
      return response.json()