FCCS MCP Agentic Server

Instructions

Implementation Reference

• fccs_agent/tools/dimensions.py:32-54 (handler)

  The main handler function implementing get_members tool: retrieves dimension members from FCCS client with caching support.

  async def get_members(dimension_name: str) -> dict[str, Any]:
      """Get members of a specific dimension / Obter membros de uma dimensao especifica.
  
      Args:
          dimension_name: The name of the dimension.
  
      Returns:
          dict: List of dimension members.
      """
      cache = get_cache_service()
      cache_key = f"members:{dimension_name}"
      
      if cache:
          cached_data = cache.get(cache_key)
          if cached_data:
              return {"status": "success", "data": cached_data, "source": "cache"}
  
      members = await _client.get_members(_app_name, dimension_name)
      
      if cache and members:
          cache.set(cache_key, members, ttl_seconds=86400)  # Cache for 24 hours
          
      return {"status": "success", "data": members, "source": "fccs"}

• fccs_agent/tools/dimensions.py:102-114 (schema)

  JSON schema definition for the get_members tool input, part of TOOL_DEFINITIONS list.

      "name": "get_members",
      "description": "Get members of a specific dimension / Obter membros de uma dimensao especifica",
      "inputSchema": {
          "type": "object",
          "properties": {
              "dimension_name": {
                  "type": "string",
                  "description": "The name of the dimension",
              },
          },
          "required": ["dimension_name"],
      },
  },

• fccs_agent/agent.py:148-150 (registration)

  Registration of dimension tools including get_members in the central TOOL_HANDLERS dictionary.

  "get_dimensions": dimensions.get_dimensions,
  "get_members": dimensions.get_members,
  "get_dimension_hierarchy": dimensions.get_dimension_hierarchy,