Remote MCP
Connect directly to Valyu’s hosted MCP server for real-time searches across academic papers, web content, and financial data
Get $10 free credits for the Valyu API when you sign up at Valyu!
Valyu MCP Server enables AI assistants like Claude to perform real-time searches through the Valyu Deepsearch API, allowing them to access up-to-date information from the web, academic journals and textbooks, and financial data. It is open-source, checkout GitHub.
Remote Valyu MCP
Connect directly to Valyu’s hosted MCP server (instead of running it locally).
Remote Valyu MCP URL
Get your API key from platform.valyu.network/user/account/apikeys.
Configuration
Claude Desktop Configuration
Add this to your Claude Desktop configuration file:
OpenAI Responses API
This is how to try out the Valyu MCP server in the OpenAI playground.
Easily hook up the Valyu MCP server to the OpenAI Responses API:
Available Tools
Valyu MCP includes four specialized search tools optimized for different types of information:
Tool | Description |
---|---|
valyu_search | General search across all sources (academic, web, proprietary). Perfect for comprehensive research queries requiring diverse information sources. |
valyu_web_search | Real-time web search with domain filtering. Optimized for current events, news, and up-to-date web content. |
valyu_academic_search | Academic papers and research from arXiv, PubMed, and other scholarly sources. Ideal for scientific research and academic literature reviews. |
valyu_financial_search | Financial data including stocks, cryptocurrency, forex, and market information. Provides structured financial datasets and market analysis. |
Tool Parameters
valyu_search
- query (required): Search query string
- search_type:
'all'
(default),'proprietary'
, or'web'
- max_num_results: 1-50 results (default: 10)
- max_price: Maximum cost per 1000 retrievals in dollars (default: 30)
- relevance_threshold: 0.0-1.0 relevance score threshold (default: 0.4)
- included_sources: Array of specific data sources
- included_domains: Comma-separated domains for web search
- start_date: Filter from date (YYYY-MM-DD)
- end_date: Filter until date (YYYY-MM-DD)
- category: Content category filter
valyu_web_search
- query (required): Web search query
- max_num_results: 1-50 results (default: 10)
- included_domains: Comma-separated domains (e.g., ‘cnn.com,bbc.com’)
- start_date: Filter from date (YYYY-MM-DD)
- end_date: Filter until date (YYYY-MM-DD)
valyu_academic_search
- query (required): Academic research query
- max_num_results: 1-20 results (default: 10)
- included_sources: Academic sources (e.g., [‘valyu/valyu-arxiv’, ‘valyu/valyu-pubmed’])
- start_date: Filter from date (YYYY-MM-DD)
- end_date: Filter until date (YYYY-MM-DD)
- category: Research category (e.g., ‘machine learning’, ‘finance’)
valyu_financial_search
- query (required): Financial query (e.g., ‘AAPL stock price’, ‘Bitcoin volatility’)
- max_num_results: 1-50 results (default: 10)
- included_sources: Financial sources (e.g., [‘valyu/valyu-stocks-US’, ‘valyu/valyu-crypto’])
- start_date: Filter from date (YYYY-MM-DD)
- end_date: Filter until date (YYYY-MM-DD)
Response Format
All tools return structured responses with essential fields:
- title: Content title or headline
- url: Source URL
- content: Main content (text or structured data)
For financial queries, responses include structured data with OHLC values, timestamps, and market metrics.
Usage Examples
Once configured, you can ask your AI assistant to perform various types of searches:
General Research
“Search for recent developments in renewable energy storage technologies”
Academic Research
“Find academic papers published in 2024 about machine learning applications in drug discovery”
Web Search
“Search for recent news about artificial intelligence regulations from government websites”
Financial Analysis
“Get Tesla stock performance data for the last quarter and analyze the trends”
Domain-Specific Searches
“Search Bloomberg and Reuters for recent analysis on cryptocurrency market trends”
Date-Filtered Research
“Find academic papers from 2023-2024 about climate change mitigation strategies”
Features
- Multi-source Integration: Access academic papers, real-time web content, and financial data from a single interface
- Advanced Filtering: Date ranges, domain restrictions, source selection, and relevance thresholds
- Cost Management: Configurable price limits to control API usage costs
- High Relevance: Tunable relevance thresholds ensure quality results
- Structured Financial Data: Time-series data with OHLC values for market analysis
- Real-time Information: Up-to-date web content and current market data
- OpenAI Compatible: Direct integration with OpenAI’s Responses API
Transport Protocol
Uses HTTP/SSE transport (JSON-RPC over HTTP with Server-Sent Events) for:
- ✅ Direct OpenAI Responses API compatibility
- ✅ Real-time streaming responses
- ✅ Stateless authentication via URL parameters
- ✅ Standard MCP protocol compliance
Pricing
Valyu MCP operates on a usage-based pricing model through Valyu’s Deepsearch API. Configure max_price
parameters to control costs per search operation. Visit Valyu Pricing for current rates.
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
Support
- Documentation: docs.valyu.network
- API Keys: platform.valyu.network/user/account/apikeys
- Platform: platform.valyu.network