Remote MCP

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 — Copy your MCP URL from the Valyu Platform and paste it into your AI client

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:

Tool	Description
`valyu_search`	The world’s most powerful web search that returns full page content. Perfect for current events, technical documentation, and any web-accessible information.
`valyu_academic_search`	Full-text academic search across ArXiv, PubMed, and scholarly databases. Returns peer-reviewed papers with complete metadata including authors, citations, DOI, and references.
`valyu_financial_search`	Real-time financial intelligence covering stocks (NASDAQ/NYSE), crypto, forex, earnings reports, balance sheets, insider transactions, and market movers.
`valyu_sec_search`	Search 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_research`	NEW! 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_patents`	Search patent databases for inventions, innovations, and intellectual property. Returns patent documents with claims, abstracts, inventors, and filing information.
`valyu_bio_search`	Comprehensive 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_search`	Economic data from BLS, FRED, World Bank, and USAspending. Access labor statistics, economic indicators, GDP, inflation rates, and government spending data.
`valyu_contents`	Extract clean, structured content from any URL. Returns full page content in markdown format with metadata extraction.
`valyu_datasources`	Tool 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_categories`	List 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:

valyu_sec_search - filings and insider transactions

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.

valyu_company_research - company intelligence

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.

valyu_contents - URL extraction

Takes a urls array (max 10 per request) and returns clean markdown with metadata.

valyu_datasources / valyu_datasources_categories - discovery

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

Documentation: docs.valyu.ai
API Keys: platform.valyu.ai/user/account/apikeys
Platform: platform.valyu.ai

Agents & MCP

Automation Platforms

Work Platforms

Framework SDKs

Community SDKs

LLM Providers

Remote Valyu MCP

Remote Valyu MCP URL

Copy Your MCP URL

Claude Connector Integration

OpenAI Responses API

Available Tools

Transport

Pricing

Cost Control

Additional Resources

Valyu Platform

Documentation

Blog

GitHub

Support

​Remote Valyu MCP

​Remote Valyu MCP URL

​Copy Your MCP URL

​Claude Connector Integration

​OpenAI Responses API

​Available Tools

​Transport

​Pricing

​Cost Control

​Additional Resources

Valyu Platform

Documentation

Blog

GitHub

​Support

Remote Valyu MCP

Remote Valyu MCP URL

Copy Your MCP URL

Claude Connector Integration

OpenAI Responses API

Available Tools

Transport

Pricing

Cost Control

Additional Resources

Support