Stock News Search (Tavily)

🚀 Stock News Search MCP Server

The Stock News Search MCP Server is compatible with various MCP clients and enables real - time stock news search!

🔌 Compatible with Cline, Cursor, Claude Desktop, and any other MCP clients!

The Stock News Search MCP Server can run seamlessly on all MCP clients.

The Model Context Protocol (MCP) is an open standard that enables AI systems to interact with their data sources and tools, establishing a secure two - way connection.

The Stock News Search MCP Server offers the following features:

• Real - time stock news search using the Tavily API
• Multiple customizable search query templates
• Configurable search parameters and filtering options
• Content filtering for specific domains
• Type - safe operations (using TypeScript)

🚀 Quick Start

Prerequisites 🔧

Before you start, make sure you have:

• A Tavily API Key
• Claude Desktop, Cursor, or other MCP - compatible clients
• Node.js (v16 or higher)
• Git installed (only required for the Git installation method)

📦 Installation

Run with NPX

npx -y search-stock-news-mcp@latest

Install via Smithery

To automatically install the Stock News Search MCP Server for Claude Desktop:

npx -y @smithery/cli install search-stock-news-mcp --client claude

⚙️ Configure MCP Clients

Configure Cline 🤖

The easiest way to set up the Stock News Search MCP Server with Cline in VS Code is through the marketplace:

1. Open Cline in VS Code.
2. Click the Cline icon in the sidebar.
3. Switch to the "MCP Servers" tab.
4. Search for "Stock News" and click "Install".
5. When prompted, enter your Tavily API Key.

Alternatively, manually configure the server settings in Cline:

{
  "mcp": {
    "servers": {
      "stock-news-search": {
        "type": "search",
        "implementation": "StockNewsSearchMCP"
      }
    }
  }
}

Configure Cursor 🕷️

Add the following to your configuration file:

{
  "mcp": {
    "servers": {
      "stock-news-search": {
        "type": "search",
        "implementation": "StockNewsSearchMCP"
      }
    }
  }
}

Configure Claude Desktop 👨💻

Add the following to your claudemate.yaml file:

mcp:
  servers:
    stock-news-search:
      type: search
      implementation: StockNewsSearchMCP

💻 Usage Examples

Search for News

Use the following command to search for Google's AI news:

curl -X POST "http://localhost:1234/api/v1/mcp/stock-news-search" \
     -H "Content-Type: application/json" \
     -d '{"query":"Google AI news", "source":"article"}'

Search for a Company

Use the following command to search for Apple's news:

curl -X POST "http://localhost:1234/api/v1/mcp/stock-news-search" \
     -H "Content-Type: application/json" \
     -d '{"query":"Apple Inc", "source":"press-release"}'

🚨 Troubleshooting

Common Issues

1. Server not found

   • Check if the npm installation is correct.
   • Confirm that the configuration syntax is error - free.
   • Ensure that Node.js is installed correctly.

2. API Key issues

   • Verify that your Tavily API Key is valid.
   • Check if the API Key is set correctly in the configuration.
   • Make sure there are no spaces or quotes in the API Key.

3. Search result issues

   • Confirm that the search parameters are within the valid range.
   • Check if the domain filtering is correctly formatted.
   • Ensure that the company name and stock code are accurate.

✨ Acknowledgments

• Model Context Protocol for providing the MCP specification.
• Anthropic for providing Claude Desktop.
• Tavily for providing the news search API.

📄 License

MIT