Skip to main content
Get $10 free credits ($20 with a work email) when you sign up at Valyu. Usable across every source. No card required.
Best for: using Valyu yourself. Connect Valyu to Claude, Cursor, or any MCP client over the hosted server.

Paste into your AI assistant to wire up the Valyu remote MCP server.

Open in Cursor
Valyu MCP Server enables AI assistants like Claude to perform real-time searches through the Valyu Search 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

https://mcp.valyu.ai/mcp?valyuApiKey=your-valyu-api-key
Get your API key from platform.valyu.ai/user/account/apikeys.

​
Copy Your MCP URL

The easiest way to connect your AI assistant to Valyu is to copy your personalized MCP URL directly from the Valyu Platform. It comes pre-filled with your API key, just copy and paste it into your client.
Valyu MCP Server URL on the platform

​
Claude Connector Integration

Add the Valyu MCP server to Claude. Add it as a custom connector. Go to claude.ai/settings/connectors → Add custom connector → Paste URL → Done!

​
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: 
from openai import OpenAI
client = OpenAI()

response = client.responses.create(
  model="gpt-5",
  input=[],
  text={
    "format": {
      "type": "text"
    }
  },
  reasoning={},
  tools=[
    {
      "type": "mcp",
      "server_label": "Valyu",
      "server_url": "https://mcp.valyu.ai/mcp?valyuApiKey=VALYU_API_KEY",
      "allowed_tools": [
        "valyu_search",
        "valyu_academic_search",
        "valyu_financial_search",
        "valyu_sec_search",
        "valyu_company_research",
        "valyu_patents",
        "valyu_bio_search",
        "valyu_economics_search",
        "valyu_contents",
        "valyu_datasources",
        "valyu_datasources_categories"
      ],
      "require_approval": "always"
    }
  ],
  temperature=1,
  max_output_tokens=2048,
  top_p=1,
  store=True
)

import OpenAI from "openai";

const openai = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
});

const response = await openai.responses.create({
  model: "gpt-5",
  input: [],
  text: {
    "format": {
      "type": "text"
    }
  },
  reasoning: {},
  tools: [
    {
      "type": "mcp",
      "server_label": "Valyu",
      "server_url": "https://mcp.valyu.ai/mcp?valyuApiKey=VALYU_API_KEY",
      "allowed_tools": [
        "valyu_search",
        "valyu_academic_search",
        "valyu_financial_search",
        "valyu_sec_search",
        "valyu_company_research",
        "valyu_patents",
        "valyu_bio_search",
        "valyu_economics_search",
        "valyu_contents",
        "valyu_datasources",
        "valyu_datasources_categories"
      ],
      "require_approval": "always"
    }
  ],
  temperature: 1,
  max_output_tokens: 2048,
  top_p: 1,
  store: true
});

​
Available Tools

Valyu MCP provides 11 specialized tools for comprehensive information retrieval across multiple domains:
ToolDescription
valyu_searchThe world’s most powerful web search that returns full page content. Perfect for current events, technical documentation, and any web-accessible information.
valyu_academic_searchFull-text academic search across ArXiv, PubMed, and scholarly databases. Returns peer-reviewed papers with complete metadata including authors, citations, DOI, and references.
valyu_financial_searchReal-time financial intelligence covering stocks (NASDAQ/NYSE), crypto, forex, earnings reports, balance sheets, insider transactions, and market movers.
valyu_sec_searchSearch SEC filings (10-K, 10-Q, 8-K) and insider transactions (Form 4 structured data). Find specific sections like MD&A, risk factors, or business strategy from any public company’s regulatory filings.
valyu_company_researchNEW! Comprehensive company intelligence reports in ~10 seconds. Automatically gathers and synthesizes information across business overview, leadership, products, funding, competitors, financials, and recent news. Uses parallel execution to deliver complete reports 4x faster than sequential searches.
valyu_patentsSearch patent databases for inventions, innovations, and intellectual property. Returns patent documents with claims, abstracts, inventors, and filing information.
valyu_bio_searchComprehensive biomedical and healthcare search across PubMed, bioRxiv, medRxiv, clinical trials, FDA drug labels, ChEMBL, PubChem, Open Targets, NPI Registry, and WHO ICD. Perfect for medical research, drug discovery, healthcare provider lookup, and disease classification.
valyu_economics_searchEconomic data from BLS, FRED, World Bank, and USAspending. Access labor statistics, economic indicators, GDP, inflation rates, and government spending data.
valyu_contentsExtract clean, structured content from any URL. Returns full page content in markdown format with metadata extraction.
valyu_datasourcesTool manifest for AI agents to discover available data sources. Lists 36+ integrated datasets with metadata, schemas, and pricing. Filter by category for targeted discovery.
valyu_datasources_categoriesList all available datasource categories with dataset counts. Use to discover filtering options for the datasources tool.
Most tools take a query string and an optional max_num_results (1-20, up to 100 with a special API key). A few have extras:
Covers 10-K, 10-Q, 8-K, and Form 4 insider transactions. response_length controls content size: "short" (~25k chars), "medium" (~50k, default), "large" (~100k), "max" (up to ~400k, complete filings). Searchable across MD&A, risk factors, business strategy, financial condition, and legal proceedings.
Takes company (name, ticker, or domain) and an optional sections array: summary, leadership, products, funding, competitors, filings, financials, news, insiders. Returns a cited markdown report; queries sections in parallel and adapts to public vs private companies.
Takes a urls array (max 10 per request) and returns clean markdown with metadata.
valyu_datasources lists available datasets (optionally filtered by category) with schemas and pricing. valyu_datasources_categories lists every category with dataset counts.
Once connected, ask your assistant in natural language - “Tesla’s latest 10-K MD&A section”, “clinical trials for CAR-T therapy in lymphoma”, “US unemployment rate trends 2024”, or “research the company Anthropic”. The assistant picks the right tool.

​
Transport

Uses HTTP/SSE transport (JSON-RPC over HTTP with Server-Sent Events) for OpenAI Responses API compatibility, streaming responses, and stateless auth via URL parameters.

​
Pricing

Valyu MCP operates on a usage-based pricing model through the Valyu API. You can control costs by setting the maxPrice parameter in the URL.

​
Cost Control

Set the maxPrice parameter to limit spending per search operation: 
https://mcp.valyu.ai/mcp?valyuApiKey=your-key&maxPrice=50
  • Optional: Only applies when provided. If not provided, adjusts automatically based on search type and max number of results
  • Minimum: 1 CPM ($0.01) minimum cost per search
  • Recommended: 30-100 CPM ($0.03-$0.10) for most use cases
Visit Valyu Pricing for detailed cost information.

​
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