> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Python MCP Server

> Guide for creating a custom Python MCP server for stock price retrieval

## Custom Python MCP Server

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
flowchart LR
    In[Query] --> Agent[AI Agent]
    Agent --> Client[Python MCP Client]
    Client --> Server[Python MCP Server]
    Server --> Client
    Client --> Agent
    Agent --> Out[Answer]
    
    style In fill:#8B0000,color:#fff
    style Agent fill:#2E8B57,color:#fff
    style Client fill:#3776AB,color:#fff
    style Server fill:#3776AB,color:#fff
    style Out fill:#8B0000,color:#fff
```

## Overview

The Custom Python MCP Server is a simple implementation of the Model Context Protocol (MCP) that provides stock price information using the yfinance library. This server can be used with PraisonAI agents to retrieve real-time stock prices.

## Server Implementation

Below is the complete implementation of the custom Python MCP server:

## Quick Start

<Steps>
  <Step title="Install Dependencies">
    Install the required packages:

    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    pip install yfinance mcp
    ```
  </Step>

  <Step title="Save the Server Code">
    Save the code above to a file named `custom-python-server.py`.

    ```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    import yfinance as yf
    from mcp.server.fastmcp import FastMCP

    mcp = FastMCP("stock_prices")

    @mcp.tool()
    async def get_stock_price(ticker: str) -> str:
        """Get the current stock price for a given ticker symbol.
        
        Args:
            ticker: Stock ticker symbol (e.g., AAPL, MSFT, GOOG)
            
        Returns:
            Current stock price as a string
        """
        if not ticker:
            return "No ticker provided"
        try:
            stock = yf.Ticker(ticker)
            info = stock.info
            current_price = info.get('currentPrice') or info.get('regularMarketPrice')
            if not current_price:
                return f"Could not retrieve price for {ticker}"
            return f"${current_price:.2f}"
            
        except Exception as e:
            return f"Error: {str(e)}"

    if __name__ == "__main__":
        mcp.run(transport='stdio')
    ```
  </Step>
</Steps>

<Note>
  **Requirements**

  * Python 3.10 or higher
  * yfinance package
  * mcp package
</Note>