Add documentation for MCP_DISABLE_EMBEDDED_RESOURCES feature flag

- Added Feature Flags section to server-configuration.md
- Added troubleshooting note to Antigravity installation guide
- Fixed linter issue in result_test.go
- Generated updated documentation

Co-authored-by: SamMorrowDrums <4811358+SamMorrowDrums@users.noreply.github.com>

Author: Copilot

docs/installation-guides/install-antigravity.md

@@ -102,6 +102,14 @@ If you prefer running the server locally with Docker:
 
 ## Troubleshooting
 
+### File contents not displaying properly
+
+If you experience issues with the `get_file_contents` tool not displaying file contents correctly, this may be due to limited embedded resource support in some versions of Antigravity.
+
+**Solution:** The remote GitHub MCP Server will soon support the `MCP_DISABLE_EMBEDDED_RESOURCES` feature flag to improve compatibility. This flag makes file contents return as standard MCP content types that work better across different clients.
+
+For updates on this feature, see the [Server Configuration Guide](../server-configuration.md#feature-flags).
+
 ### "Error: serverUrl or command must be specified"
 
 Make sure you're using `serverUrl` (not `url`) for the remote server configuration. Antigravity requires `serverUrl` for HTTP-based MCP servers.

docs/server-configuration.md

@@ -345,6 +345,52 @@ See [Scope Filtering](./scope-filtering.md) for details on how filtering works w
 
 ---
 
+## Feature Flags
+
+The GitHub MCP Server supports runtime feature flags that can modify tool behavior for improved compatibility with different MCP clients.
+
+### MCP_DISABLE_EMBEDDED_RESOURCES
+
+**Purpose:** Improves compatibility with MCP clients that don't fully support embedded resources.
+
+When enabled, the `get_file_contents` tool returns file content as standard MCP content types instead of embedded resources:
+- **Text files**: Returned as `TextContent` with MIME type in metadata
+- **Binary files**: Returned as `ImageContent` with base64-encoded data
+
+**When to use:** Enable this flag if your MCP client has issues displaying or accessing file contents retrieved via `get_file_contents`.
+
+**Configuration:**
+
+<table>
+<tr><th>Remote Server</th><th>Local Server</th></tr>
+<tr valign="top">
+<td>
+
+**Coming soon:** Remote server support for this flag will be available in the next release.
+
+</td>
+<td>
+
+Feature flags are checked at runtime via the feature flag checker. Configuration method depends on your deployment:
+
+**For custom integrations:**
+```go
+featureChecker := func(ctx context.Context, flagName string) (bool, error) {
+    if flagName == "MCP_DISABLE_EMBEDDED_RESOURCES" {
+        return true, nil // Enable the flag
+    }
+    return false, nil
+}
+```
+
+</td>
+</tr>
+</table>
+
+> **Note:** This feature flag does not affect other tools, only `get_file_contents`. The default behavior (embedded resources) is maintained when the flag is not enabled, ensuring backward compatibility.
+
+---
+
 ## Troubleshooting
 
 | Problem | Cause | Solution |

pkg/github/repositories_test.go

@@ -519,7 +519,7 @@ func Test_GetFileContents_WithDisabledEmbeddedResourcesFlag(t *testing.T) {
 			// Setup client with mock
 			client := github.NewClient(tc.mockedClient)
 			mockRawClient := raw.NewClient(client, &url.URL{Scheme: "https", Host: "raw.example.com", Path: "/"})
-			
+
 			// Create feature flag checker
 			featureChecker := func(_ context.Context, flagName string) (bool, error) {
 				if flagName == FeatureFlagDisableEmbeddedResources {

pkg/utils/result_test.go

@@ -1,4 +1,4 @@
-package utils
+package utils //nolint:revive //TODO: figure out a better name for this package
 
 import (
 	"encoding/base64"
@@ -89,7 +89,7 @@ func TestNewToolResultResourceWithFlag_EnabledFlag_BinaryContent(t *testing.T) {
 	// Second content should be ImageContent (not embedded resource)
 	imageContent, ok := result.Content[1].(*mcp.ImageContent)
 	require.True(t, ok, "Expected ImageContent but got %T", result.Content[1])
-	
+
 	// Data should be base64 encoded
 	expectedBase64 := base64.StdEncoding.EncodeToString(binaryData)
 	assert.Equal(t, []byte(expectedBase64), imageContent.Data)