gemini-faf-mcp

Instructions

Implementation Reference

• server.py:317-348 (handler)

  The faf_about() function is the handler for the 'faf_about' MCP tool. It returns a dictionary with metadata about the FAF format including name, media type, IANA registration status, specification URL, server version, SDK info, available tools count, ecosystem integrations, and the tier system. The function is decorated with @mcp.tool() which registers it as an MCP tool.

  @mcp.tool()
  def faf_about() -> dict:
      """FAF format info — IANA registration, version, ecosystem.
      Returns metadata about the FAF format, server version, and available MCP bridges.
      Use this when users ask what FAF is or how it connects to other AI platforms."""
      return {
          "name": "FAF (Foundational AI-context Format)",
          "media_type": "application/vnd.faf+yaml",
          "iana_registered": True,
          "spec": "https://faf.one",
          "server": "gemini-faf-mcp",
          "server_version": __version__,
          "sdk": "faf-python-sdk",
          "tools": 12,
          "ecosystem": {
              "claude": "claude-faf-mcp (npm)",
              "gemini": "gemini-faf-mcp (PyPI)",
              "grok": "grok-faf-mcp (npm)",
              "cli": "faf-cli (npm)",
              "rust": "rust-faf-mcp (crates.io)",
          },
          "tier_system": {
              "100%": "Trophy",
              "99%": "Gold",
              "95%": "Silver",
              "85%": "Bronze",
              "70%": "Green",
              "55%": "Yellow",
              "<55%": "Red",
              "0%": "White",
          },
      }

• server.py:20-24 (registration)

  The FastMCP server instance 'mcp' is created here. This instance provides the @mcp.tool() decorator used to register tools including faf_about. The decorator pattern automatically registers decorated functions as MCP tools with the server.

  mcp = FastMCP(
      "gemini-faf-mcp",
      version=__version__,
      instructions="FAF — Universal AI context from IANA-registered .faf files",
  )