Get $10 free credits for the Valyu API when you sign up at Valyu!

​
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:
  • Proprietary data sources
  • Wikipedia
  • arXiv
  • PubMed
  • Financial data
  • Web search

​
Prerequisites

Before you begin, ensure you have:
  • Python 3.10 or higher - Claude Desktop (latest version) - Valyu API Key
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: 
bash macOS/Linux python -m venv .venv source .venv/bin/activate  bash     Windows python -m venv .venv .venv\Scripts\activate
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

Open the config file: bash 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"
      }
    }
  }
}
Replace the paths with absolute paths to your Python virtual environment and the script location.

​
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.
Valyu MCP Tools Interface
  1. 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.
Example of Valyu MCP Response

​
Monitoring Logs

For debugging or troubleshooting, you can view the server logs:
bash tail -n 20 -F ~/Library/Logs/Claude/mcp*.log
You can also access logs through Claude Desktop → Settings → Developer → Open Logs Folder. Failed MCP servers will have dedicated log files with complete error traces.

​
Troubleshooting

​
Additional Resources

Valyu Platform

Get your API key and free credits

Documentation

Explore the full Valyu API documentation

Blog

Read about our latest updates

GitHub

View source code and contribute

​
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.
Visit valyu.network to learn more about what we’re building at Valyu.