Claude Agent SDK Integration

Best for: building Valyu into your product / agents. Add Valyu search tools to agents built on the Claude Agent SDK. This is a community-maintained integration by GhouI - for official integrations, see Vercel AI SDK or the Valyu API directly.

Domain-specific Valyu search tools exposed to the Claude Agent SDK over the Model Context Protocol (MCP), so your agents can search academic papers, financial data, patents, and more.

Paste into your AI assistant to wire Valyu search tools into a Claude Agent SDK project.

Open in Cursor

The integration includes search tools for:

Web Search: Real-time information, news, and current events
Finance Search: Stock prices, earnings reports, SEC filings, and financial metrics
Paper Search: Academic research from arXiv and scholarly databases
Bio Search: Biomedical literature, PubMed articles, and clinical trials
Patent Search: Patent databases and prior art research
SEC Search: Regulatory documents (10-K, 10-Q, 8-K filings)
Economics Search: Labor statistics, Federal Reserve data, World Bank indicators
Company Research: Comprehensive intelligence reports with synthesized data

Installation

Clone the community-maintained repository and install dependencies:

git clone https://github.com/GhouI/valyu-claude-agent-sdk.git
cd valyu-claude-agent-sdk

npm install --legacy-peer-deps

yarn install --legacy-peer-deps

pnpm install --legacy-peer-deps

The --legacy-peer-deps flag is required due to Zod version compatibility requirements.

Configure credentials by adding your Valyu API key to a .env file:

VALYU_API_KEY=your-valyu-api-key-here

The package automatically reads this environment variable.

Free Credits

Get your API key with $10 free credits ($20 with a work email) from the Valyu Platform.

Basic Usage

Web Search Example

Search for real-time information, news, and current events:

import { query } from "@anthropic-ai/claude-agent-sdk";
import { valyuWebSearchServer } from "./tools/index.js";

async function webSearchExample() {
  for await (const message of query({
    prompt: "What are the latest developments in AI technology?",
    options: {
      model: "claude-sonnet-4-5",
      allowedTools: ["mcp__valyu-web-search__web_search"],
      mcpServers: {
        "valyu-web-search": valyuWebSearchServer,
      },
    },
  })) {
    if (message.type === "assistant") {
      const textContent = message.content
        .filter((block) => block.type === "text")
        .map((block) => block.text)
        .join("\n");
      console.log(textContent);
    }
  }
}

await webSearchExample();

Every tool follows the same shape - import its server, list it in allowedTools, register it under mcpServers. Route each query to the most specific tool.

Available tools

Tool	Server import	`allowedTools` id
Web	`valyuWebSearchServer`	`mcp__valyu-web-search__web_search`
Finance	`valyuFinanceSearchServer`	`mcp__valyu-finance-search__finance_search`
Paper	`valyuPaperSearchServer`	`mcp__valyu-paper-search__paper_search`
Bio	`valyuBioSearchServer`	`mcp__valyu-bio-search__bio_search`
Patent	`valyuPatentSearchServer`	`mcp__valyu-patent-search__patent_search`
SEC	`valyuSecSearchServer`	`mcp__valyu-sec-search__sec_search`
Economics	`valyuEconomicsSearchServer`	`mcp__valyu-economics-search__economics_search`
Company research	`valyuCompanyResearchServer`	`mcp__valyu-company-research__company_research`

Combine multiple tools

import { query } from "@anthropic-ai/claude-agent-sdk";
import {
  valyuWebSearchServer,
  valyuFinanceSearchServer,
  valyuCompanyResearchServer,
} from "./tools/index.js";

for await (const message of query({
  prompt: "Analyze Nvidia's market position and competitive landscape",
  options: {
    model: "claude-sonnet-4-5",
    allowedTools: [
      "mcp__valyu-web-search__web_search",
      "mcp__valyu-finance-search__finance_search",
      "mcp__valyu-company-research__company_research",
    ],
    mcpServers: {
      "valyu-web-search": valyuWebSearchServer,
      "valyu-finance-search": valyuFinanceSearchServer,
      "valyu-company-research": valyuCompanyResearchServer,
    },
  },
})) {
  // handle messages
}

Custom search parameters

createBioSearchServer() (and the equivalents for other tools) accept:

searchType - "proprietary" or "web" (default "proprietary")
maxNumResults - default 10
includedSources - e.g. ["pubmed", "clinicaltrials.gov"]
maxPrice - max cost per query, CPM (default 30.0)
relevanceThreshold - 0.0-1.0 (default 0.5)
category - focus area, e.g. "biomedical"

const customServer = createBioSearchServer({
  includedSources: ["pubmed", "clinicaltrials.gov"],
  maxNumResults: 10,
  relevanceThreshold: 0.7,
});

Additional Resources

GitHub Repository

Community-maintained Claude Agent SDK integration source code

API Reference

Complete Valyu API documentation

Claude Agent SDK

Official Anthropic Claude Agent SDK

Get API Key

Support

This is a community-maintained integration. For issues or contributions:

GitHub Issues: Report issues or request features

Agents & MCP

Automation Platforms

Work Platforms

Framework SDKs

Community SDKs

LLM Providers

Claude Agent SDK

Installation

Free Credits

Basic Usage

Web Search Example

Available tools

Combine multiple tools

Additional Resources

GitHub Repository

API Reference

Claude Agent SDK

Get API Key

Support

​Installation

Free Credits

​Basic Usage

​Web Search Example

​Available tools

​Combine multiple tools

​Additional Resources

GitHub Repository

API Reference

Claude Agent SDK

Get API Key

​Support

Installation

Basic Usage

Web Search Example

Available tools

Combine multiple tools

Additional Resources

Support