FCCS MCP Agentic Server

Instructions

Implementation Reference

• fccs_agent/tools/data.py:246-270 (handler)

  Primary MCP tool handler function for 'clear_data'. Builds parameters from optional inputs (scenario, year, period) and delegates to the underlying FCCS client method.

  async def clear_data(
      scenario: Optional[str] = None,
      year: Optional[str] = None,
      period: Optional[str] = None
  ) -> dict[str, Any]:
      """Clear data for specified scenario, year, and period / Limpar dados.
  
      Args:
          scenario: Scenario to clear.
          year: Year to clear.
          period: Period to clear.
  
      Returns:
          dict: Job submission result.
      """
      parameters = {}
      if scenario:
          parameters["scenario"] = scenario
      if year:
          parameters["year"] = year
      if period:
          parameters["period"] = period
  
      result = await _client.clear_data(_app_name, parameters)
      return {"status": "success", "data": result}

• fccs_agent/tools/data.py:409-420 (schema)

  JSON schema definition for the 'clear_data' tool input validation, part of TOOL_DEFINITIONS list used by MCP.

  {
      "name": "clear_data",
      "description": "Clear data for specified scenario, year, and period / Limpar dados",
      "inputSchema": {
          "type": "object",
          "properties": {
              "scenario": {"type": "string", "description": "Scenario to clear"},
              "year": {"type": "string", "description": "Year to clear"},
              "period": {"type": "string", "description": "Period to clear"},
          },
      },
  },

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

  Registration of the 'clear_data' tool handler in the central TOOL_HANDLERS dictionary, mapping name to data.clear_data function.

  "clear_data": data.clear_data,

• fccs_agent/client/fccs_client.py:567-582 (helper)

  Supporting client method in FccsClient that submits the CLEARDATA job to the FCCS REST API endpoint.

  async def clear_data(
      self,
      app_name: str,
      parameters: dict[str, Any]
  ) -> dict[str, Any]:
      """Clear data / Limpar dados."""
      if self.config.fccs_mock_mode:
          return {"jobId": "402", "status": "Submitted", "jobType": "ClearData"}
  
      payload = {"jobType": "CLEARDATA", **parameters}
      response = await self._client.post(
          f"/{app_name}/jobs{self._get_query_params()}",
          json=payload
      )
      response.raise_for_status()
      return response.json()

• fccs_agent/agent.py:193-195 (registration)

  Inclusion of data.py TOOL_DEFINITIONS (containing clear_data schema) into the aggregated ALL_TOOL_DEFINITIONS for MCP server.

  data.TOOL_DEFINITIONS +
  reports.TOOL_DEFINITIONS +
  consolidation.TOOL_DEFINITIONS +