New description of the Linkup tool in the Python MCP and general Readme (vs. focused on Claude Desktop) (#7)

* updated description

* visualize

* cleanup

* Update README.md

Co-authored-by: Clément Jumel <[email protected]>

* Update README.md

---------

Co-authored-by: Philippe Mizrahi <[email protected]>
Co-authored-by: Clément Jumel <[email protected]>

Author: 3 people

README.md

@@ -1,73 +1,55 @@
-# 🌟 Linkup for Claude: Internet Access for Your AI Assistant
+# 🌟 Linkup Python MCP Server
 
-Give Claude access to real-time knowledge and premium content. Get rid of Claude's cutoff data and
-transform Claude's responses with current events, and trusted, premium sources through Linkup's
-powerful search capability.
+A Model Context Protocol (MCP) server that provides web search capabilities through Linkup's advanced search API. This server enables AI assistants and development tools to perform intelligent web searches with natural language queries.
 
 <a href="https://glama.ai/mcp/servers/69qbbv8hl9"><img width="380" height="200" src="https://glama.ai/mcp/servers/69qbbv8hl9/badge" alt="mcp-search-linkup MCP server" /></a>
 
-## ⚡️ Get Started in 60 Seconds
+## ✨ Why Linkup?
 
-1. [Download Linkup for Claude](https://linkup.so/linkup-for-claude)
-2. Sign in to Claude Desktop
-3. Open Linkup & connect your account
-4. Click "_Allow for This Chat_" when prompted
+- 🔍 **Advanced Web Search**: Leverage Linkup's AI-powered search engine for high-quality, relevant results
+- 💬 **Natural Language Queries**: Ask questions in plain English or your preferred language - no need for keyword optimization
+- 🚀 **Real-time Information**: Access up-to-date web content and current information
+- 📚 **Comprehensive Results**: Get detailed search results with source citations
+- 🔧 **Easy Integration**: Works with any MCP-compatible client
 
-Done! Claude is now supercharged with internet access. 🎉
+## 🚀 Installation
 
-## 🎭 Experience the Difference
+The Linkup MCP server can be used with any MCP-compatible client. 
 
-Claude without Linkup stops at April 2024. With Linkup, Claude accesses current events, premium
-content, and trusted sources to provide up-to-date, accurate information in every conversation.
+For an integration with Claude Desktop or with Cursor, please follow instruction [here](https://docs.linkup.so/pages/integrations/mcp/mcp).
 
-Ask Claude anything like:
+For other MCP-compatible clients, use these connection details:
 
-```
-"Why did McLaren win F1 championship 2024?"
-"What's the latest breakthrough in cancer research?"
-"Can you summarize for me the latest news about the war in Ukraine ?"
-"Please help me to find latest data about Global GDP growth rate"
-```
+- **Command**: `python -m linkup_mcp_server`
+- **Required Environment Variables**: `LINKUP_API_KEY`
 
-## 💎 Premium Features
+Consult your MCP client's documentation for specific configuration instructions.
 
-Linkup gives Claude access to:
+## 💬 Example Queries
 
-- 📰 Premium content
-- 🔥 Real-time news and updates
+The Linkup MCP server excels at answering complex questions and finding specific information:
 
-## 💬 From Our Users
+- "What are the latest developments in quantum computing?"
+- "How does the EU AI Act affect startups?"
+- "Find recent research on sustainable aviation fuel"
+- "What are the current best practices for MCP server development?"
 
-```
-"My use of Claude was limited by its cutoff date and lack of up-to-date information. This problem is now solved, and I can use Claude for end-to-end tasks"
-- François, data engineer in a tech company
-```
+## 🤝 Contributing
 
-```
-"The work the team has been doing with the MCP is absolutely mind-blowing. Making it accessible to non-developers makes it even more powerful"
-- Fred, PM in a tech company
-```
+Pull requests are welcome! Feel free to open an issue first to discuss what you’d like to see improved.
 
-```
-"With this installer, I was able to catch the importance of both Linkup product and the Claude's MCP"
-- Elisa, VC
-```
+## 📚 Resources
 
-## 🤝 Community & Support
+- [Linkup Documentation](https://docs.linkup.so)
+- [MCP Protocol Specification](https://modelcontextprotocol.io)
+- [Linkup API Reference](https://docs.linkup.so/api-reference)
 
-[Discord](https://discord.com/invite/9q9mCYJa86)
+## 📣 Community & Support
 
-[X](https://x.com/Linkup_platform)
-
-[Linkedin](https://www.linkedin.com/company/linkup-platform/)
+* Email: [[email protected]](mailto:[email protected])
+* Discord: [Join our community](https://discord.com/invite/9q9mCYJa86)
+* X / Twitter: [@Linkup_platform](https://x.com/Linkup_platform)
 
 ## 📄 License
 
-MIT License - Innovate freely! 🚀
-
----
-
-<p align="center">
-<strong>✨ Upgrade Claude. Get Linkup. ✨</strong><br>
-<a href="https://linkup.so/linkup-for-claude">Download</a> • <a href="https://docs.linkup.so/">Docs</a>
-</p>
+This project is licensed under the MIT License - Innovate freely! 🚀

src/mcp_search_linkup/server.py

@@ -29,25 +29,19 @@ async def handle_list_tools() -> list[types.Tool]:
     return [
         types.Tool(
             name="search-web",
-            description="Performs an online search using Linkup search engine and retrieves the "
-            "top results as a string. This function is useful for accessing real-time information, "
-            "including news, articles, and other relevant web content.",
+            description="Search the web in real time using Linkup. Use this tool whenever the user needs trusted facts, news, or source-backed information. Returns comprehensive content from the most relevant sources.",
             inputSchema={
                 "type": "object",
                 "properties": {
                     "query": {
                         "type": "string",
-                        "description": "The search query to perform.",
+                        "description": "Natural language search query. Full questions work best, e.g., 'How does the new EU AI Act affect startups?'",
                     },
                     "depth": {
                         "type": "string",
                         "description": "The search depth to perform. Use 'standard' for "
-                        "straightforward queries with likely direct answers (e.g., facts, "
-                        "definitions, simple explanations). Use 'deep' for: 1) complex queries "
-                        "requiring comprehensive analysis or information synthesis, 2) queries "
-                        "containing uncommon terms, specialized jargon, or abbreviations that may "
-                        "need additional context, or 3) questions likely requiring up-to-date or "
-                        "specialized web search results to answer effectively.",
+                        "queries with likely direct answers. Use 'deep' for complex queries "
+                        "requiring comprehensive analysis or multi-hop questions",
                         "enum": ["standard", "deep"],
                     },
                 },