MCP

​

Overview

The Valyu MCP Server is a Model Context Protocol (MCP) tool that enables AI models to retrieve high-quality context from Valyu’s API. It provides comprehensive search capabilities across:

• Wikipedia
• arXiv
• Web search

​

Prerequisites

Before you begin, ensure you have:

Verify your Python version:

python --version

​

Quick Start

​

1. Clone and Setup

First, clone the repository and set up your environment:

git clone https://github.com/valyu-network/valyu-mcp.git
cd valyu-mcp

Create and activate a virtual environment:

Install dependencies:

pip install -r requirements.txt

​

2. Configure Environment

Create a .env file with your API key:

echo "VALYU_API_KEY=your-api-key-here" > .env

​

3. Set Up Claude Configuration

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the Valyu MCP server configuration:

{
  "mcpServers": {
    "valyu-mcp": {
      "command": "/ABSOLUTE/PATH/TO/.venv/bin/python",
      "args": ["-u", "/ABSOLUTE/PATH/TO/valyu-mcp.py"],
      "env": {
        "VALYU_API_KEY": "your-api-key-here"
      }
    }
  }
}

​

Testing Your Setup

Once Claude Desktop restarts, you can confirm if your server is working properly:

1. Look for the Tools Icon

   A hammer icon (tools) should appear in the Claude Desktop interface when your MCP server is running successfully.

2. Inspect Available Tools

   Click the hammer icon to see the list of available tools. You should see valyu-mcp listed among the tools.

3. Try Example Queries

   Test the MCP server with queries that would benefit from Valyu’s context retrieval. For example:

   “What are the latest advancements in topological quantum computing”

   “Find recent research papers about agentic retrievel-augmented generation.”

   “Explain the concept of volatility clustering in financial markets.”

   Claude will indicate it’s “Making a tool request: valyu-mcp” and then fetch context from the Valyu API.

​

Monitoring Logs

For debugging or troubleshooting, you can view the server logs:

tail -n 20 -F ~/Library/Logs/Claude/mcp*.log

​

Troubleshooting

​

Additional Resources

​

Contributing

We welcome contributions! Feel free to:

• Open issues for bug reports
• Submit feature requests
• Create pull requests

​

License

This project is licensed under the MIT License.