FCCS MCP Agentic Server

Instructions

Implementation Reference

• fccs_agent/tools/jobs.py:31-41 (handler)

  The main tool handler function that executes the get_job_status logic by calling the FCCS client.

  async def get_job_status(job_id: str) -> dict[str, Any]:
      """Get the status of a specific job / Obter o status de um job especifico.
  
      Args:
          job_id: The ID of the job to check.
  
      Returns:
          dict: Job status details.
      """
      status = await _client.get_job_status(_app_name, job_id)
      return {"status": "success", "data": status}

• fccs_agent/tools/jobs.py:95-108 (schema)

  The input schema definition for the get_job_status tool, specifying the required 'job_id' parameter.

  {
      "name": "get_job_status",
      "description": "Get the status of a specific job / Obter o status de um job especifico",
      "inputSchema": {
          "type": "object",
          "properties": {
              "job_id": {
                  "type": "string",
                  "description": "The ID of the job to check / O ID do job para verificar",
              },
          },
          "required": ["job_id"],
      },
  },

• fccs_agent/agent.py:142-146 (registration)

  Registration of the get_job_status tool handler in the central TOOL_HANDLERS dictionary used by the agent.

  # Jobs
  "list_jobs": jobs.list_jobs,
  "get_job_status": jobs.get_job_status,
  "run_business_rule": jobs.run_business_rule,
  "run_data_rule": jobs.run_data_rule,

• fccs_agent/client/fccs_client.py:132-145 (helper)

  The FCCS client helper method invoked by the tool handler to retrieve job status from the REST API.

  async def get_job_status(self, app_name: str, job_id: str) -> dict[str, Any]:
      """Get job status / Obter status do trabalho."""
      if self.config.fccs_mock_mode:
          return MOCK_JOB_STATUS.get(
              job_id,
              {"jobId": job_id, "status": "Unknown", "details": "Mock job not found"}
          )
  
      response = await self._client.get(
          f"/{app_name}/jobs/{job_id}{self._get_query_params()}"
      )
      response.raise_for_status()
      return response.json()