FCCS MCP Agentic Server

Instructions

Implementation Reference

• fccs_agent/tools/consolidation.py:66-78 (handler)

  The main async handler function that executes the tool logic by delegating to the FCCS client to generate the intercompany matching report.

  async def generate_intercompany_matching_report(
      parameters: Optional[dict[str, Any]] = None
  ) -> dict[str, Any]:
      """Generate intercompany matching report / Gerar relatorio de correspondencia ICP.
  
      Args:
          parameters: Report parameters (scenario, year, period, etc.).
  
      Returns:
          dict: Job submission result.
      """
      result = await _client.generate_intercompany_matching_report(_app_name, parameters)
      return {"status": "success", "data": result}

• fccs_agent/tools/consolidation.py:188-200 (schema)

  The tool schema definition including name, description, and input schema for parameters.

  {
      "name": "generate_intercompany_matching_report",
      "description": "Generate intercompany matching report / Gerar relatorio de correspondencia ICP",
      "inputSchema": {
          "type": "object",
          "properties": {
              "parameters": {
                  "type": "object",
                  "description": "Report parameters (scenario, year, period, etc.)",
              },
          },
      },
  },

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

  Registration of the tool handler in the agent's TOOL_HANDLERS dictionary.

  "generate_intercompany_matching_report": consolidation.generate_intercompany_matching_report,

• fccs_agent/client/fccs_client.py:643-658 (helper)

  Supporting client method that performs the actual HTTP POST to FCCS jobs endpoint with jobType INTERCOMPANYMATCHING.

  async def generate_intercompany_matching_report(
      self,
      app_name: str,
      parameters: Optional[dict[str, Any]] = None
  ) -> dict[str, Any]:
      """Generate intercompany matching report / Gerar relatorio ICP."""
      if self.config.fccs_mock_mode:
          return {"jobId": "501", "status": "Submitted", "jobType": "IntercompanyMatching"}
  
      payload = {"jobType": "INTERCOMPANYMATCHING", **(parameters or {})}
      response = await self._client.post(
          f"/{app_name}/jobs{self._get_query_params()}",
          json=payload
      )
      response.raise_for_status()
      return response.json()