phone-a-friend-mcp-server 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

phone_a_friend_mcp_server/__init__.py

@@ -15,7 +15,8 @@ from phone_a_friend_mcp_server.server import serve
 @click.option("--model", help="Model to use (e.g., 'gpt-4', 'anthropic/claude-3.5-sonnet')")
 @click.option("--provider", help="Provider type ('openai', 'openrouter', 'anthropic', 'google')")
 @click.option("--base-url", help="Base URL for API")
-def main(verbose: int, api_key: str = None, model: str = None, provider: str = None, base_url: str = None) -> None:
+@click.option("--temperature", type=float, help="Temperature for the model (0.0-2.0). Lower values = more deterministic, higher = more creative")
+def main(verbose: int, api_key: str = None, model: str = None, provider: str = None, base_url: str = None, temperature: float = None) -> None:
     """MCP server for Phone-a-Friend AI consultation"""
     logging_level = logging.WARN
     if verbose == 1:
@@ -25,7 +26,6 @@ def main(verbose: int, api_key: str = None, model: str = None, provider: str = N
 
     logging.basicConfig(level=logging_level, stream=sys.stderr)
 
-    # Read environment variables with proper precedence
     config_api_key = (
         api_key
         or os.environ.get("OPENROUTER_API_KEY")
@@ -37,15 +37,12 @@ def main(verbose: int, api_key: str = None, model: str = None, provider: str = N
     config_model = model or os.environ.get("PHONE_A_FRIEND_MODEL")
     config_provider = provider or os.environ.get("PHONE_A_FRIEND_PROVIDER")
     config_base_url = base_url or os.environ.get("PHONE_A_FRIEND_BASE_URL")
-
-    # Initialize configuration
+    config_temperature = temperature
     try:
-        config = PhoneAFriendConfig(api_key=config_api_key, model=config_model, provider=config_provider, base_url=config_base_url)
+        config = PhoneAFriendConfig(api_key=config_api_key, model=config_model, provider=config_provider, base_url=config_base_url, temperature=config_temperature)
     except ValueError as e:
         click.echo(f"Configuration error: {e}", err=True)
         sys.exit(1)
-
-    # Start the server
     asyncio.run(serve(config))
 
 

phone_a_friend_mcp_server/config.py

@@ -1,28 +1,30 @@
+import os
+
+
 class PhoneAFriendConfig:
     """Centralized configuration for Phone-a-Friend MCP server."""
 
-    def __init__(self, api_key: str | None = None, model: str | None = None, base_url: str | None = None, provider: str | None = None) -> None:
+    def __init__(self, api_key: str | None = None, model: str | None = None, base_url: str | None = None, provider: str | None = None, temperature: float | None = None) -> None:
         """Initialize configuration with provided values.
 
         Args:
             api_key: API key for external AI services
             model: Model to use (e.g., 'gpt-4', 'anthropic/claude-3.5-sonnet')
             base_url: Custom base URL for API (optional, providers use defaults)
-            provider: Provider type ('openai', 'openrouter', 'anthropic')
+            provider: Provider type ('openai', 'openrouter', 'anthropic', 'google')
+            temperature: Temperature value for the model (0.0-2.0), overrides defaults
         """
         self.api_key = api_key
         self.provider = provider or self._detect_provider()
         self.model = model or self._get_default_model()
-        self.base_url = base_url  # Only use if explicitly provided
+        self.base_url = base_url
+        self.temperature = self._validate_temperature(temperature)
 
-        # Validate required configuration
         if not self.api_key:
             raise ValueError(f"Missing required API key for {self.provider}. Set {self._get_env_var_name()} environment variable or pass --api-key")
 
     def _detect_provider(self) -> str:
         """Detect provider based on available environment variables."""
-        import os
-
         if os.environ.get("OPENROUTER_API_KEY"):
             return "openrouter"
         elif os.environ.get("ANTHROPIC_API_KEY"):
@@ -32,12 +34,11 @@ class PhoneAFriendConfig:
         elif os.environ.get("OPENAI_API_KEY"):
             return "openai"
         else:
-            # Default to OpenAI
             return "openai"
 
     def _get_default_model(self) -> str:
         """Get default model based on provider."""
-        models = {"openai": "o3", "openrouter": "anthropic/claude-4-opus", "anthropic": "claude-4-opus", "google": "gemini-2.5-pro-preview-05-06"}
+        models = {"openai": "o3", "openrouter": "anthropic/claude-4-opus", "anthropic": "claude-4-opus", "google": "gemini-2.5-pro-preview-06-05"}
         if self.provider not in models:
             raise ValueError(f"Unknown provider: {self.provider}. Supported providers: {list(models.keys())}")
         return models[self.provider]
@@ -46,3 +47,41 @@ class PhoneAFriendConfig:
         """Get environment variable name for the provider."""
         env_vars = {"openai": "OPENAI_API_KEY", "openrouter": "OPENROUTER_API_KEY", "anthropic": "ANTHROPIC_API_KEY", "google": "GOOGLE_API_KEY or GEMINI_API_KEY"}
         return env_vars.get(self.provider, "OPENAI_API_KEY")
+
+    def _validate_temperature(self, temperature: float | None) -> float | None:
+        """Validate temperature value or get from environment variable."""
+        temp_value = temperature
+        if temp_value is None:
+            env_temp = os.environ.get("PHONE_A_FRIEND_TEMPERATURE")
+            if env_temp is not None:
+                try:
+                    temp_value = float(env_temp)
+                except ValueError:
+                    raise ValueError(f"Invalid temperature value in PHONE_A_FRIEND_TEMPERATURE: {env_temp}")
+
+        if temp_value is None:
+            temp_value = self._get_default_temperature_for_model()
+
+        if temp_value is not None:
+            if not isinstance(temp_value, int | float):
+                raise ValueError(f"Temperature must be a number, got {type(temp_value).__name__}")
+            if not (0.0 <= temp_value <= 2.0):
+                raise ValueError(f"Temperature must be between 0.0 and 2.0, got {temp_value}")
+
+        return temp_value
+
+    def _get_default_temperature_for_model(self) -> float | None:
+        """Get default temperature for specific models that benefit from it."""
+        default_temperatures = {
+            "gemini-2.5-pro-preview-06-05": 0.0,
+        }
+
+        return default_temperatures.get(self.model)
+
+    def get_temperature(self) -> float | None:
+        """Get the temperature setting for the current model.
+
+        Returns:
+            Temperature value if set, None otherwise
+        """
+        return self.temperature

phone_a_friend_mcp_server/server.py

@@ -12,6 +12,22 @@ from phone_a_friend_mcp_server.tools.tool_manager import ToolManager
 logger = logging.getLogger(__name__)
 
 
+def _format_tool_result(result: Any) -> str:
+    """Format tool result for display."""
+    if isinstance(result, dict):
+        formatted_result = ""
+        for key, value in result.items():
+            if isinstance(value, list):
+                formatted_result += f"{key.title()}:\n"
+                for item in value:
+                    formatted_result += f"  • {item}\n"
+            else:
+                formatted_result += f"{key.title()}: {value}\n"
+        return formatted_result.strip()
+    else:
+        return str(result)
+
+
 async def serve(config: PhoneAFriendConfig) -> None:
     """Start the Phone-a-Friend MCP server.
 
@@ -55,19 +71,8 @@ async def serve(config: PhoneAFriendConfig) -> None:
             logger.info(f"Calling tool: {name} with arguments: {arguments}")
             tool = tool_manager.get_tool(name)
             result = await tool.run(**arguments)
-
-            if isinstance(result, dict):
-                formatted_result = ""
-                for key, value in result.items():
-                    if isinstance(value, list):
-                        formatted_result += f"{key.title()}:\n"
-                        for item in value:
-                            formatted_result += f"  • {item}\n"
-                    else:
-                        formatted_result += f"{key.title()}: {value}\n"
-                return [TextContent(type="text", text=formatted_result.strip())]
-            else:
-                return [TextContent(type="text", text=str(result))]
+            formatted_result = _format_tool_result(result)
+            return [TextContent(type="text", text=formatted_result)]
 
         except Exception as e:
             logger.error("Tool execution failed: %s", e)

phone_a_friend_mcp_server/tools/fax_tool.py

@@ -23,7 +23,12 @@ class FaxAFriendTool(BaseTool):
 
     @property
     def description(self) -> str:
-        return """🚨  **USE ONLY WHEN USER ASKS TO "fax a friend".**
+        return """🚨🚨🚨 **EXCLUSIVE USE ONLY** 🚨🚨🚨
+
+**USE ONLY WHEN USER EXPLICITLY ASKS TO "fax a friend"**
+**DO NOT use as fallback if phone_a_friend fails**
+**DO NOT auto-switch between fax/phone tools**
+**If this tool fails, ask user for guidance - do NOT try phone_a_friend**
 
 Purpose: pair-programming caliber *coding help* — reviews, debugging,
 refactors, design, migrations.
@@ -107,21 +112,34 @@ replacing <file="…"> blocks as needed. Commentary goes outside those tags."""
                         'Bad: vague stuff like "make code better".'
                     ),
                 },
+                "output_directory": {
+                    "type": "string",
+                    "description": (
+                        "Directory path where the fax_a_friend.md file will be created.\n"
+                        "Recommended: Use the user's current working directory for convenience.\n"
+                        "Must be a valid, writable directory path.\n"
+                        "Examples: '/tmp', '~/Documents', './output', '/Users/username/Desktop'"
+                    ),
+                },
             },
-            "required": ["all_related_context", "task"],
+            "required": ["all_related_context", "task", "output_directory"],
         }
 
     async def run(self, **kwargs) -> dict[str, Any]:
         all_related_context = kwargs.get("all_related_context", "")
         any_additional_context = kwargs.get("any_additional_context", "")
         task = kwargs.get("task", "")
+        output_directory = kwargs.get("output_directory", "")
 
         # Create master prompt using the same logic as phone_a_friend
         master_prompt = self._create_master_prompt(all_related_context, any_additional_context, task)
 
         try:
-            # Write to fax_a_friend.md in current working directory
-            file_path = "fax_a_friend.md"
+            # Validate and prepare output directory
+            output_dir = self._prepare_output_directory(output_directory)
+
+            # Create full file path
+            file_path = os.path.join(output_dir, "fax_a_friend.md")
 
             async with aiofiles.open(file_path, "w", encoding="utf-8") as f:
                 await f.write(master_prompt)
@@ -133,6 +151,7 @@ replacing <file="…"> blocks as needed. Commentary goes outside those tags."""
                 "status": "success",
                 "file_path": abs_path,
                 "file_name": "fax_a_friend.md",
+                "output_directory": output_dir,
                 "prompt_length": len(master_prompt),
                 "context_length": len(all_related_context + any_additional_context),
                 "task": task,
@@ -140,7 +159,7 @@ replacing <file="…"> blocks as needed. Commentary goes outside those tags."""
             }
 
         except Exception as e:
-            return {"status": "failed", "error": str(e), "file_path": "fax_a_friend.md", "context_length": len(all_related_context + any_additional_context), "task": task}
+            return {"status": "failed", "error": str(e), "output_directory": output_directory, "context_length": len(all_related_context + any_additional_context), "task": task}
 
     def _create_master_prompt(self, all_related_context: str, any_additional_context: str, task: str) -> str:
         """Create a comprehensive prompt identical to PhoneAFriendTool's version."""
@@ -180,6 +199,27 @@ replacing <file="…"> blocks as needed. Commentary goes outside those tags."""
 
         return "\n".join(prompt_parts)
 
+    def _prepare_output_directory(self, output_directory: str) -> str:
+        """Validate and prepare the output directory."""
+        if not output_directory:
+            raise ValueError("output_directory parameter is required")
+
+        # Expand user path (~) and resolve relative paths
+        expanded_path = os.path.expanduser(output_directory)
+        resolved_path = os.path.abspath(expanded_path)
+
+        # Create directory if it doesn't exist
+        try:
+            os.makedirs(resolved_path, exist_ok=True)
+        except OSError as e:
+            raise ValueError(f"Cannot create directory '{resolved_path}': {e}")
+
+        # Check if directory is writable
+        if not os.access(resolved_path, os.W_OK):
+            raise ValueError(f"Directory '{resolved_path}' is not writable")
+
+        return resolved_path
+
     def _get_manual_workflow_instructions(self, file_path: str) -> str:
         """Generate clear instructions for the manual workflow."""
         return f"""

phone_a_friend_mcp_server/tools/phone_tool.py

@@ -28,7 +28,12 @@ class PhoneAFriendTool(BaseTool):
 
     @property
     def description(self) -> str:
-        return """🚨  **USE ONLY WHEN USER ASKS TO "phone a friend".**
+        return """🚨🚨🚨 **EXCLUSIVE USE ONLY** 🚨🚨🚨
+
+**USE ONLY WHEN USER EXPLICITLY ASKS TO "phone a friend"**
+**DO NOT use as fallback if fax_a_friend fails**
+**DO NOT auto-switch between phone/fax tools**
+**If this tool fails, ask user for guidance - do NOT try fax_a_friend**
 
 Purpose: pair-programming caliber *coding help* — reviews, debugging,
 refactors, design, migrations.
@@ -118,57 +123,57 @@ replacing <file="…"> blocks as needed. Commentary goes outside those tags."""
         any_additional_context = kwargs.get("any_additional_context", "")
         task = kwargs.get("task", "")
 
-        # Create master prompt for external AI
         master_prompt = self._create_master_prompt(all_related_context, any_additional_context, task)
 
         try:
-            # Create Pydantic-AI agent with appropriate provider
             agent = self._create_agent()
+            temperature = self.config.get_temperature()
 
-            # Send to external AI
-            result = await agent.run(master_prompt)
+            if temperature is not None:
+                result = await agent.run(master_prompt, model_settings={"temperature": temperature})
+            else:
+                result = await agent.run(master_prompt)
 
             return {
                 "response": result.data,
                 "status": "success",
                 "provider": self.config.provider,
                 "model": self.config.model,
+                "temperature": temperature,
                 "context_length": len(all_related_context + any_additional_context),
                 "task": task,
             }
 
         except Exception as e:
+            temperature = self.config.get_temperature()
             return {
                 "error": str(e),
                 "status": "failed",
                 "provider": self.config.provider,
                 "model": self.config.model,
+                "temperature": temperature,
                 "context_length": len(all_related_context + any_additional_context),
                 "task": task,
-                "master_prompt": master_prompt,  # Include for debugging
+                "master_prompt": master_prompt,
             }
 
     def _create_agent(self) -> Agent:
         """Create Pydantic-AI agent with appropriate provider."""
         if self.config.provider == "openrouter":
-            # OpenRouter has its own dedicated provider
             provider_kwargs = {"api_key": self.config.api_key}
             if self.config.base_url:
                 provider_kwargs["base_url"] = self.config.base_url
             provider = OpenRouterProvider(**provider_kwargs)
             model = OpenAIModel(self.config.model, provider=provider)
         elif self.config.provider == "anthropic":
-            # Use Anthropic directly
             provider_kwargs = {"api_key": self.config.api_key}
             provider = AnthropicProvider(**provider_kwargs)
             model = AnthropicModel(self.config.model, provider=provider)
         elif self.config.provider == "google":
-            # Use Google/Gemini directly
             provider_kwargs = {"api_key": self.config.api_key}
             provider = GoogleProvider(**provider_kwargs)
             model = GoogleModel(self.config.model, provider=provider)
         else:
-            # Default to OpenAI
             provider_kwargs = {"api_key": self.config.api_key}
             if self.config.base_url:
                 provider_kwargs["base_url"] = self.config.base_url

phone_a_friend_mcp_server-0.1.2.dist-info/METADATA

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: phone-a-friend-mcp-server
+Version: 0.1.2
+Summary: MCP Server for Phone-a-Friend assistance
+Project-URL: GitHub, https://github.com/abhishekbhakat/phone-a-friend-mcp-server
+Project-URL: Issues, https://github.com/abhishekbhakat/phone-a-friend-mcp-server/issues
+Author-email: Abhishek Bhakat <abhishek.bhakat@hotmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Requires-Dist: aiofiles>=24.1.0
+Requires-Dist: aiohttp>=3.12.7
+Requires-Dist: click>=8.2.1
+Requires-Dist: mcp>=1.9.2
+Requires-Dist: pydantic-ai-slim[anthropic,google,openai]>=0.2.14
+Requires-Dist: pydantic>=2.11.5
+Requires-Dist: pyyaml>=6.0.0
+Description-Content-Type: text/markdown
+
+# Phone-a-Friend MCP Server 🧠📞
+
+An AI-to-AI consultation system that enables one AI to "phone a friend" (another AI) for critical thinking, long context reasoning, and complex problem solving via OpenRouter.
+
+## The Problem 🤔
+
+Sometimes an AI encounters complex problems that require:
+- **Deep critical thinking** beyond immediate capabilities
+- **Long context reasoning** with extensive information
+- **Multi-step analysis** that benefits from external perspective
+- **Specialized expertise** from different AI models
+
+## The Solution �
+
+Phone-a-Friend MCP Server creates a **two-step consultation process**:
+
+1. **Context + Reasoning**: Package all relevant context and send to external AI for deep analysis
+2. **Extract Actionable Insights**: Process the reasoning response into usable format for the primary AI
+
+This enables AI systems to leverage other AI models as "consultants" for complex reasoning tasks.
+
+## Architecture 🏗️
+
+```
+Primary AI → Phone-a-Friend MCP → OpenRouter → External AI (GPT-4, Claude, etc.) → Processed Response → Primary AI
+```
+
+**Sequential Workflow:**
+1. `analyze_context` - Gather and structure all relevant context
+2. `get_critical_thinking` - Send context to external AI via OpenRouter for reasoning
+3. `extract_actionable_insights` - Process response into actionable format
+
+## When to Use 🎯
+
+**Ideal for:**
+- Complex multi-step problems requiring deep analysis
+- Situations needing long context reasoning (>100k tokens)
+- Cross-domain expertise consultation
+- Critical decision-making with high stakes
+- Problems requiring multiple perspectives
+
+## Installation 🚀
+
+1. Clone the repository:
+```bash
+git clone https://github.com/abhishekbhakat/phone-a-friend-mcp-server.git
+cd phone-a-friend-mcp-server
+```
+
+2. Install dependencies:
+```bash
+uv pip install -e .
+```
+
+3. Configure API access (choose one method):
+
+**Option A: Environment Variables**
+```bash
+export OPENROUTER_API_KEY="your-openrouter-key"
+# OR
+export OPENAI_API_KEY="your-openai-key"
+# OR
+export ANTHROPIC_API_KEY="your-anthropic-key"
+# OR
+export GOOGLE_API_KEY="your-google-key"
+```
+
+**Option B: CLI Arguments**
+```bash
+phone-a-friend-mcp-server --api-key "your-api-key" --provider openai
+```
+
+## Usage 💡
+
+### Command Line Options
+```bash
+
+# Custom base URL (if needed)
+phone-a-friend-mcp-server --base-url "https://custom-api.example.com"
+
+# Temperature control (0.0 = deterministic, 2.0 = very creative)
+phone-a-friend-mcp-server --temperature 0.4
+
+# Combined example
+phone-a-friend-mcp-server --api-key "sk-..." --provider openai --model "o3" -v
+```
+
+### Environment Variables (Optional)
+```bash
+
+# Optional model overrides
+export PHONE_A_FRIEND_MODEL="your-preferred-model"
+export PHONE_A_FRIEND_PROVIDER="your-preferred-provider"
+export PHONE_A_FRIEND_BASE_URL="https://custom-api.example.com"
+
+# Temperature control (0.0-2.0, where 0.0 = deterministic, 2.0 = very creative)
+export PHONE_A_FRIEND_TEMPERATURE=0.4
+```
+
+## Model Selection 🤖
+
+Default reasoning models to be selected:
+- **OpenAI**: o3
+- **Anthropic**: Claude 4 Opus
+- **Google**: Gemini 2.5 Pro Preview 05-06 (automatically set temperature to 0.0)
+- **OpenRouter**: For other models like Deepseek or Qwen
+
+You can override the auto-selection by setting `PHONE_A_FRIEND_MODEL` environment variable or using the `--model` CLI option.
+
+## Available Tools 🛠️
+
+### phone_a_friend
+📞 Consult external AI for critical thinking and complex reasoning. Makes API calls to get responses.
+
+### fax_a_friend
+📠 Generate master prompt file for manual AI consultation. Creates file for copy-paste workflow.
+
+**Parameters (both tools):**
+- `all_related_context` (required): All context related to the problem
+- `any_additional_context` (optional): Additional helpful context
+- `task` (required): Specific task or question for the AI
+
+
+## Use Cases 🎯
+
+1. In-depth Reasoning for Vibe Coding
+2. For complex algorithms, data structures, or mathematical computations
+3. Frontend Development with React, Vue, CSS, or modern frontend frameworks
+
+## Claude Desktop Configuration 🖥️
+
+To use Phone-a-Friend MCP server with Claude Desktop, add this configuration to your `claude_desktop_config.json` file:
+
+### Configuration File Location
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Configuration
+
+**Option 1: Using uv (Recommended)**
+```json
+{
+  "mcpServers": {
+    "phone-a-friend": {
+      "command": "uvx",
+      "args": [
+        "--refresh",
+        "phone-a-friend-mcp-server",
+      ],
+      "env": {
+        "OPENROUTER_API_KEY": "your-openrouter-api-key",
+        "PHONE_A_FRIEND_MODEL": "anthropic/claude-4-opus",
+        "PHONE_A_FRIEND_TEMPERATURE": "0.4"
+      }
+    }
+  }
+}
+```
+
+### Environment Variables in Configuration
+
+You can configure different AI providers directly in the Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "phone-a-friend": {
+      "command": "phone-a-friend-mcp-server",
+      "env": {
+        "OPENROUTER_API_KEY": "your-openrouter-api-key",
+        "PHONE_A_FRIEND_MODEL": "anthropic/claude-4-opus",
+        "PHONE_A_FRIEND_TEMPERATURE": "0.4"
+      }
+    }
+  }
+}
+```
+
+## License 📄
+
+MIT License - see LICENSE file for details.

phone_a_friend_mcp_server-0.1.2.dist-info/RECORD

@@ -0,0 +1,15 @@
+phone_a_friend_mcp_server/__init__.py,sha256=9sn_dPrIzLz4W7_Ww--o8aUxIhUI3YGNrxPa26pKShw,2025
+phone_a_friend_mcp_server/__main__.py,sha256=A-8-jkY2FK2foabew5I-Wk2A54IwzWZcydlQKfiR-p4,51
+phone_a_friend_mcp_server/config.py,sha256=McHqEzIVhSXpfmNLrCRlrFckRLzjxN5LESkqAXX6c4o,3953
+phone_a_friend_mcp_server/server.py,sha256=z-O20j-j2oHFfFK8o0u9kn-MR8Q-Te0lRZOQfLkYUbM,3448
+phone_a_friend_mcp_server/client/__init__.py,sha256=fsa8DXjz4rzYXmOUAdLdTpTwPSlZ3zobmBGXqnCEaWs,47
+phone_a_friend_mcp_server/tools/__init__.py,sha256=jtuvmcStXzbaM8wuhOKC8M8mBqDjHr-ypZ2ct1Rgi7Q,46
+phone_a_friend_mcp_server/tools/base_tools.py,sha256=DMjFq0E3TO9a9I7QY4wQ_B4-SntdXzSZzrYymFzSmVE,765
+phone_a_friend_mcp_server/tools/fax_tool.py,sha256=qPKTDG1voXo_6MjgkMSDLN8AKYfal6sagK1l2BRPgCw,9399
+phone_a_friend_mcp_server/tools/phone_tool.py,sha256=fPgYE8iRc9xFCQc07J5Zh4RPIbgYaiE6WygTEo6oUbs,8604
+phone_a_friend_mcp_server/tools/tool_manager.py,sha256=VVtENC-n3D4GV6Cy3l9--30SJi06mJdyEiG7F_mfP7I,1474
+phone_a_friend_mcp_server-0.1.2.dist-info/METADATA,sha256=sMh-qLXluzJMAR0YZcA-OaSajsxq4tAKODDNyG8Y_tc,6222
+phone_a_friend_mcp_server-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+phone_a_friend_mcp_server-0.1.2.dist-info/entry_points.txt,sha256=c_08XI-vG07VmUT3mtzyuCQjaus5l1NBl4q00Q3jLug,86
+phone_a_friend_mcp_server-0.1.2.dist-info/licenses/LICENSE,sha256=-8bInetillKZC0qZDT8RWYIOrph3HIU5cr5N4Pg7bBE,1065
+phone_a_friend_mcp_server-0.1.2.dist-info/RECORD,,

phone_a_friend_mcp_server-0.1.0.dist-info/METADATA

@@ -1,320 +0,0 @@
-Metadata-Version: 2.4
-Name: phone-a-friend-mcp-server
-Version: 0.1.0
-Summary: MCP Server for Phone-a-Friend assistance
-Project-URL: GitHub, https://github.com/abhishekbhakat/phone-a-friend-mcp-server
-Project-URL: Issues, https://github.com/abhishekbhakat/phone-a-friend-mcp-server/issues
-Author-email: Abhishek Bhakat <abhishek.bhakat@hotmail.com>
-License-Expression: MIT
-License-File: LICENSE
-Classifier: Development Status :: 3 - Alpha
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.11
-Requires-Dist: aiofiles>=24.1.0
-Requires-Dist: aiohttp>=3.12.7
-Requires-Dist: click>=8.2.1
-Requires-Dist: mcp>=1.9.2
-Requires-Dist: pydantic-ai-slim[anthropic,google,openai]>=0.2.14
-Requires-Dist: pydantic>=2.11.5
-Requires-Dist: pyyaml>=6.0.0
-Provides-Extra: dev
-Requires-Dist: build>=1.2.2.post1; extra == 'dev'
-Requires-Dist: pre-commit>=4.2.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.26.0; extra == 'dev'
-Requires-Dist: pytest-mock>=3.14.1; extra == 'dev'
-Requires-Dist: pytest>=8.3.4; extra == 'dev'
-Requires-Dist: ruff>=0.11.12; extra == 'dev'
-Description-Content-Type: text/markdown
-
-# Phone-a-Friend MCP Server 🧠📞
-
-An AI-to-AI consultation system that enables one AI to "phone a friend" (another AI) for critical thinking, long context reasoning, and complex problem solving via OpenRouter.
-
-## The Problem 🤔
-
-Sometimes an AI encounters complex problems that require:
-- **Deep critical thinking** beyond immediate capabilities
-- **Long context reasoning** with extensive information
-- **Multi-step analysis** that benefits from external perspective
-- **Specialized expertise** from different AI models
-
-## The Solution �
-
-Phone-a-Friend MCP Server creates a **two-step consultation process**:
-
-1. **Context + Reasoning**: Package all relevant context and send to external AI for deep analysis
-2. **Extract Actionable Insights**: Process the reasoning response into usable format for the primary AI
-
-This enables AI systems to leverage other AI models as "consultants" for complex reasoning tasks.
-
-## Architecture 🏗️
-
-```
-Primary AI → Phone-a-Friend MCP → OpenRouter → External AI (GPT-4, Claude, etc.) → Processed Response → Primary AI
-```
-
-**Sequential Workflow:**
-1. `analyze_context` - Gather and structure all relevant context
-2. `get_critical_thinking` - Send context to external AI via OpenRouter for reasoning
-3. `extract_actionable_insights` - Process response into actionable format
-
-## When to Use 🎯
-
-**Ideal for:**
-- Complex multi-step problems requiring deep analysis
-- Situations needing long context reasoning (>100k tokens)
-- Cross-domain expertise consultation
-- Critical decision-making with high stakes
-- Problems requiring multiple perspectives
-
-**Not needed for:**
-- Simple factual questions
-- Basic reasoning tasks
-- Quick responses
-- Well-defined procedural tasks
-
-## Installation 🚀
-
-1. Clone the repository:
-```bash
-git clone https://github.com/abhishekbhakat/phone-a-friend-mcp-server.git
-cd phone-a-friend-mcp-server
-```
-
-2. Install dependencies:
-```bash
-uv pip install -e .
-```
-
-3. Configure your preferred AI provider:
-
-**OpenRouter (recommended - access to multiple models):**
-```bash
-export OPENROUTER_API_KEY="your-openrouter-key"
-# Model will auto-select based on provider
-```
-
-**OpenAI:**
-```bash
-export OPENAI_API_KEY="your-openai-key"
-# Uses latest available model by default
-```
-
-**Anthropic:**
-```bash
-export ANTHROPIC_API_KEY="your-anthropic-key"
-# Uses latest available model by default
-```
-
-**Google/Gemini:**
-```bash
-export GOOGLE_API_KEY="your-google-key"  # or GEMINI_API_KEY
-# Uses latest available model by default
-```
-
-## Usage 💡
-
-### Command Line
-```bash
-# Start the server
-phone-a-friend-mcp-server
-
-# With verbose logging
-phone-a-friend-mcp-server -v
-
-# With specific provider (uses optimal model automatically)
-phone-a-friend-mcp-server --provider anthropic
-phone-a-friend-mcp-server --provider google
-
-# Override with custom model if needed
-phone-a-friend-mcp-server --provider anthropic --model "your-preferred-model"
-```
-
-### Environment Variables
-```bash
-# Auto-detects provider based on available API keys
-export OPENROUTER_API_KEY="your-openrouter-key"  # Preferred
-export OPENAI_API_KEY="your-openai-key"          # Default fallback
-export ANTHROPIC_API_KEY="your-anthropic-key"    # Direct Anthropic
-export GOOGLE_API_KEY="your-google-key"          # Google/Gemini
-
-# Optional overrides (only if you want to override auto-selection)
-export PHONE_A_FRIEND_MODEL="your-preferred-model"
-export PHONE_A_FRIEND_PROVIDER="your-preferred-provider"
-```
-
-## Model Selection 🤖
-
-The system automatically selects the most capable model for each provider:
-- **OpenAI**: Latest reasoning model
-- **Anthropic**: Latest Claude model
-- **Google**: Latest Gemini Pro model
-- **OpenRouter**: Access to latest models from all providers
-
-You can override the auto-selection by setting `PHONE_A_FRIEND_MODEL` environment variable or using the `--model` CLI option.
-
-## Available Tools 🛠️
-
-### phone_a_friend
-Consult an external AI for critical thinking and complex reasoning via OpenRouter.
-
-**IMPORTANT:** The external AI is very smart but has NO MEMORY of previous conversations.
-The quality of the response depends ENTIRELY on the quality and completeness of the context you provide.
-
-**Parameters:**
-- `all_related_context` (required): ALL context directly related to the problem. Include:
-  - Background information and history
-  - Previous attempts and their outcomes
-  - Stakeholders and their perspectives
-  - Constraints, requirements, and limitations
-  - Current situation and circumstances
-  - Any relevant data, metrics, or examples
-  - Timeline and deadlines
-  - Success criteria and goals
-
-- `any_additional_context` (optional): ANY additional context that might be helpful. Include:
-  - Relevant documentation, specifications, or guidelines
-  - Industry standards or best practices
-  - Similar cases or precedents
-  - Technical details or domain knowledge
-  - Regulatory or compliance requirements
-  - Tools, resources, or technologies available
-  - Budget or resource constraints
-  - Organizational context or culture
-
-- `task` (required): The specific task or question for the external AI. Be clear about:
-  - What exactly you need help with
-  - What type of analysis or reasoning you want
-  - What format you prefer for the response
-  - What decisions need to be made
-  - What problems need to be solved
-
-**Example Usage:**
-```
-all_related_context: "We're a SaaS startup with 50 employees. Our customer churn rate increased from 5% to 12% over the last quarter. We recently changed our pricing model and added new features. Customer support tickets increased 40%. Our main competitors are offering similar features at lower prices."
-
-any_additional_context: "Industry benchmark for SaaS churn is 6-8%. Our pricing increased by 30%. New features include AI analytics and advanced reporting. Customer feedback mentions complexity and cost concerns."
-
-task: "Analyze the churn increase and provide a comprehensive action plan to reduce it back to 5% within 6 months. Include specific strategies, timeline, and success metrics."
-```
-
-The system will automatically route this to the most capable AI model available based on your configured provider.
-
-## Claude Desktop Configuration 🖥️
-
-To use Phone-a-Friend MCP server with Claude Desktop, add this configuration to your `claude_desktop_config.json` file:
-
-### Configuration File Location
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-
-### Configuration
-
-**Option 1: Using uv (Recommended)**
-```json
-{
-  "mcpServers": {
-    "phone-a-friend": {
-      "command": "uvx",
-      "args": [
-        "run",
-        "--refresh",
-        "phone-a-friend-mcp-server",
-      ],
-      "env": {
-        "OPENROUTER_API_KEY": "your-openrouter-api-key",
-        "PHONE_A_FRIEND_MODEL": "anthropic/claude-4-opus"
-      }
-    }
-  }
-}
-```
-
-### Environment Variables in Configuration
-
-You can configure different AI providers directly in the Claude Desktop config:
-
-```json
-{
-  "mcpServers": {
-    "phone-a-friend": {
-      "command": "phone-a-friend-mcp-server",
-      "env": {
-        "OPENROUTER_API_KEY": "your-openrouter-api-key",
-        "PHONE_A_FRIEND_MODEL": "anthropic/claude-4-opus"
-      }
-    }
-  }
-}
-```
-
-**Alternative Providers:**
-```json
-{
-  "mcpServers": {
-    "phone-a-friend-openai": {
-      "command": "phone-a-friend-mcp-server",
-      "env": {
-        "OPENAI_API_KEY": "your-openai-api-key"
-      }
-    },
-    "phone-a-friend-anthropic": {
-      "command": "phone-a-friend-mcp-server",
-      "env": {
-        "ANTHROPIC_API_KEY": "your-anthropic-api-key"
-      }
-    },
-    "phone-a-friend-google": {
-      "command": "phone-a-friend-mcp-server",
-      "env": {
-        "GOOGLE_API_KEY": "your-google-api-key"
-      }
-    }
-  }
-}
-```
-
-### Setup Steps
-
-1. **Install Phone-a-Friend MCP Server** (see Installation section above)
-2. **Open Claude Desktop Settings** → Developer → Edit Config
-3. **Add the configuration** (choose one of the options above)
-4. **Replace paths and API keys** with your actual values
-5. **Restart Claude Desktop**
-6. **Look for the 🔨 hammer icon** in the input box to confirm the server is connected
-
-### Troubleshooting
-
-If the server doesn't appear in Claude Desktop:
-
-1. **Check logs**:
-   - macOS: `~/Library/Logs/Claude/mcp*.log`
-   - Windows: `%APPDATA%\Claude\logs\mcp*.log`
-
-2. **Verify paths** are absolute and correct
-3. **Test manually** in terminal:
-   ```bash
-   phone-a-friend-mcp-server -v
-   ```
-4. **Restart Claude Desktop** completely
-5. **Check API keys** are valid and have sufficient credits
-
-## Development 🔧
-
-### Running Tests
-```bash
-pytest
-```
-
-### Code Formatting
-```bash
-ruff format .
-ruff check .
-```
-
-## License 📄
-
-MIT License - see LICENSE file for details.

phone_a_friend_mcp_server-0.1.0.dist-info/RECORD

@@ -1,15 +0,0 @@
-phone_a_friend_mcp_server/__init__.py,sha256=RaayGu6L95bFNEioVLZwFifnKMl9-yhUU7glBInuqXA,1895
-phone_a_friend_mcp_server/__main__.py,sha256=A-8-jkY2FK2foabew5I-Wk2A54IwzWZcydlQKfiR-p4,51
-phone_a_friend_mcp_server/config.py,sha256=Wfs68Zw7xXhAQ-77z3gblqsnmqO5bed-f2ggJkvgzUM,2356
-phone_a_friend_mcp_server/server.py,sha256=ppx8QxQvJihcOzJkrJFlh9qyZ0fvI_eGP0TgYUC0Vcw,3394
-phone_a_friend_mcp_server/client/__init__.py,sha256=fsa8DXjz4rzYXmOUAdLdTpTwPSlZ3zobmBGXqnCEaWs,47
-phone_a_friend_mcp_server/tools/__init__.py,sha256=jtuvmcStXzbaM8wuhOKC8M8mBqDjHr-ypZ2ct1Rgi7Q,46
-phone_a_friend_mcp_server/tools/base_tools.py,sha256=DMjFq0E3TO9a9I7QY4wQ_B4-SntdXzSZzrYymFzSmVE,765
-phone_a_friend_mcp_server/tools/fax_tool.py,sha256=vzcGITygR49q9cu7Fw7SYcER7u_bKY6FKfvwBGKrRGs,7573
-phone_a_friend_mcp_server/tools/phone_tool.py,sha256=zvZOU9TgC7PR6nm7rj13PPH0dRnBN9XYk2bf2frIWpE,8356
-phone_a_friend_mcp_server/tools/tool_manager.py,sha256=VVtENC-n3D4GV6Cy3l9--30SJi06mJdyEiG7F_mfP7I,1474
-phone_a_friend_mcp_server-0.1.0.dist-info/METADATA,sha256=jXvQP4I_B2uhleQWo-gIcvWntCEJfeVe0Bz2VxLI_sE,10048
-phone_a_friend_mcp_server-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-phone_a_friend_mcp_server-0.1.0.dist-info/entry_points.txt,sha256=c_08XI-vG07VmUT3mtzyuCQjaus5l1NBl4q00Q3jLug,86
-phone_a_friend_mcp_server-0.1.0.dist-info/licenses/LICENSE,sha256=-8bInetillKZC0qZDT8RWYIOrph3HIU5cr5N4Pg7bBE,1065
-phone_a_friend_mcp_server-0.1.0.dist-info/RECORD,,