FCCS MCP Agentic Server

Instructions

Implementation Reference

• fccs_agent/tools/consolidation.py:21-33 (handler)

  The primary handler function for the 'export_consolidation_rulesets' tool. It invokes the FCCS client method with the application name and parameters, wrapping the result in a success response.

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

• fccs_agent/tools/consolidation.py:149-161 (schema)

  The input schema definition for the 'export_consolidation_rulesets' tool, defining an optional 'parameters' object.

  {
      "name": "export_consolidation_rulesets",
      "description": "Export configurable consolidation rulesets / Exportar regras de consolidacao",
      "inputSchema": {
          "type": "object",
          "properties": {
              "parameters": {
                  "type": "object",
                  "description": "Export parameters (ruleNames, rulesetNames, etc.)",
              },
          },
      },
  },

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

  Registration of the tool handler in the central TOOL_HANDLERS dictionary used by the agent to dispatch tool calls.

  "export_consolidation_rulesets": consolidation.export_consolidation_rulesets,

• fccs_agent/client/fccs_client.py:586-608 (helper)

  The FCCS client helper method that makes the actual API request to export consolidation rulesets from the FCCS application.

  async def export_consolidation_rulesets(
      self,
      app_name: str,
      parameters: Optional[dict[str, Any]] = None
  ) -> dict[str, Any]:
      """Export consolidation rulesets / Exportar regras de consolidacao."""
      if self.config.fccs_mock_mode:
          return {"jobId": "301", "status": "Submitted", "jobType": "ExportRulesets"}
  
      payload = parameters or {}
      if not payload.get("ruleNames") and not payload.get("rulesetNames"):
          return {
              "status": "Parameter Required",
              "message": "Consolidation ruleset export requires specific rule names.",
              "suggestion": "Provide 'ruleNames' or 'rulesetNames' in parameters."
          }
  
      response = await self._client.post(
          f"/{app_name}/exportConfigConsolRules{self._get_query_params()}",
          json=payload
      )
      response.raise_for_status()
      return response.json()