FCCS MCP Agentic Server

Instructions

Implementation Reference

• fccs_agent/tools/data.py:207-244 (handler)

  The main asynchronous handler function for the 'copy_data' tool. It builds parameters from inputs and delegates to the FCCS client to submit a copy data job.

  async def copy_data(
      from_scenario: Optional[str] = None,
      to_scenario: Optional[str] = None,
      from_year: Optional[str] = None,
      to_year: Optional[str] = None,
      from_period: Optional[str] = None,
      to_period: Optional[str] = None
  ) -> dict[str, Any]:
      """Copy data between scenarios, years, or periods / Copiar dados entre cenarios.
  
      Args:
          from_scenario: Source scenario.
          to_scenario: Target scenario.
          from_year: Source year.
          to_year: Target year.
          from_period: Source period.
          to_period: Target period.
  
      Returns:
          dict: Job submission result.
      """
      parameters = {}
      if from_scenario:
          parameters["fromScenario"] = from_scenario
      if to_scenario:
          parameters["toScenario"] = to_scenario
      if from_year:
          parameters["fromYear"] = from_year
      if to_year:
          parameters["toYear"] = to_year
      if from_period:
          parameters["fromPeriod"] = from_period
      if to_period:
          parameters["toPeriod"] = to_period
  
      result = await _client.copy_data(_app_name, parameters)
      return {"status": "success", "data": result}

• fccs_agent/tools/data.py:394-408 (schema)

  The JSON schema definition for the 'copy_data' tool inputs, defining optional string parameters for source and target scenario, year, and period.

  {
      "name": "copy_data",
      "description": "Copy data between scenarios, years, or periods / Copiar dados",
      "inputSchema": {
          "type": "object",
          "properties": {
              "from_scenario": {"type": "string", "description": "Source scenario"},
              "to_scenario": {"type": "string", "description": "Target scenario"},
              "from_year": {"type": "string", "description": "Source year"},
              "to_year": {"type": "string", "description": "Target year"},
              "from_period": {"type": "string", "description": "Source period"},
              "to_period": {"type": "string", "description": "Target period"},
          },
      },
  },

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

  Registration of the 'copy_data' tool handler in the central TOOL_HANDLERS dictionary, mapping the tool name to its implementation.

  "copy_data": data.copy_data,

• fccs_agent/client/fccs_client.py:550-566 (helper)

  Underlying client method that performs the actual HTTP POST request to FCCS for copying data, used by the tool handler.

  async def copy_data(
      self,
      app_name: str,
      parameters: dict[str, Any]
  ) -> dict[str, Any]:
      """Copy data / Copiar dados."""
      if self.config.fccs_mock_mode:
          return {"jobId": "401", "status": "Submitted", "jobType": "CopyData"}
  
      payload = {"jobType": "COPYDATA", **parameters}
      response = await self._client.post(
          f"/{app_name}/jobs{self._get_query_params()}",
          json=payload
      )
      response.raise_for_status()
      return response.json()