Skip to main content
Enterprise-Ready AI Agents — Combine Valyu’s real-time search capabilities with AWS Bedrock AgentCore for secure, scalable, and auditable AI agent deployments.
Build sophisticated AI agents that can search financial data, academic papers, SEC filings, patents, and more — all with enterprise-grade security, OAuth authentication, and CloudTrail audit logging.
Valyu AgentCore Architecture

Why AWS Bedrock AgentCore + Valyu?

7 Specialized Search Tools

Financial data, SEC filings, academic papers, patents, biomedical research, web search, and economic indicators.

Enterprise Security

OAuth 2.0 authentication, Cognito integration, IAM policies, and CloudTrail audit logging.

Production Infrastructure

Deploy to AWS with managed scaling, monitoring, and high availability.

Simple Integration

Works with Strands Agents out of the box. Add Valyu tools in one line of code.

Get Started Free

Sign up and get $10 free credits — no credit card required. Start building in minutes.

Available Search Tools

ToolBest ForData Sources
webSearchNews, current events, general informationWeb pages, news sites
financeSearchStock prices, earnings, market analysisStocks, forex, crypto, balance sheets
paperSearchLiterature review, academic researcharXiv, PubMed, bioRxiv, medRxiv
bioSearchMedical research, drug informationPubMed, clinical trials, FDA labels
patentSearchPrior art, IP researchUSPTO patents
secSearchCompany analysis, due diligenceSEC filings (10-K, 10-Q, 8-K, proxy)
economicsSearchEconomic indicators, policy researchBLS, FRED, World Bank, US Spending

Quick Start

Installation

# For local development with Strands Agents
pip install "valyu-agentcore[strands]"

# For AWS AgentCore Gateway/Runtime deployment
pip install "valyu-agentcore[agentcore]"

Environment Setup

export VALYU_API_KEY="your-valyu-api-key"
export AWS_REGION="us-east-1"  # Optional, defaults to us-east-1
Get your free API key at platform.valyu.ai — includes $10 in credits with no credit card required.

Your First Agent

Create an AI agent with web search capability in just a few lines:
from valyu_agentcore import webSearch
from strands import Agent
from strands.models import BedrockModel

# Create an agent with Valyu search
agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    tools=[webSearch()],
)

# Ask anything
response = agent("What are the latest developments in quantum computing?")
print(response)

Multi-Tool Agent

Combine multiple search tools for comprehensive research:
from valyu_agentcore import webSearch, financeSearch, secSearch, paperSearch
from strands import Agent
from strands.models import BedrockModel

# Financial research agent with multiple data sources
agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    tools=[
        webSearch(),      # Current news and web content
        financeSearch(),  # Stock prices and financial data
        secSearch(),      # SEC filings and disclosures
        paperSearch(),    # Academic research
    ],
)

response = agent("Analyze NVIDIA's competitive position in the AI chip market")
print(response)

Using Tool Groups

The ValyuTools wrapper provides convenient tool groupings:
from valyu_agentcore import ValyuTools
from strands import Agent
from strands.models import BedrockModel

tools = ValyuTools(max_num_results=5)

# Financial analysis agent
financial_agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    tools=tools.financial_tools(),  # Includes: financeSearch, secSearch, economicsSearch
)

# Research agent
research_agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    tools=tools.research_tools(),  # Includes: paperSearch, bioSearch, patentSearch
)

# All tools
complete_agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    tools=tools.all(),  # All 7 search tools
)

Deployment Options

Choose the deployment pattern that fits your needs:
Valyu Strands Architecture

Option 1: Local Development

Best for prototyping and testing. Direct API calls with minimal setup.
from valyu_agentcore import webSearch
from strands import Agent
from strands.models import BedrockModel

agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    tools=[webSearch()],
)
Pros: Fast setup, no AWS infrastructure needed Cons: No centralized API key management, no audit logging Enterprise-grade deployment with OAuth authentication, centralized API key management, and CloudTrail logging.
Your Agent → AgentCore Gateway → Valyu MCP Server → Valyu API

             Cognito Auth
             CloudTrail Logs
             API Key Secrets
Setup Gateway:
from valyu_agentcore.gateway import setup_valyu_gateway, GatewayAgent

# One-time setup (creates Gateway + Cognito resources)
config = setup_valyu_gateway()
print(f"Gateway URL: {config.gateway_url}")

# Use the gateway-connected agent
with GatewayAgent.from_config() as agent:
    response = agent("Search for NVIDIA SEC filings")
    print(response)
Add to Existing Gateway:
from valyu_agentcore.gateway import add_valyu_target

# Add Valyu tools to your existing AgentCore Gateway
result = add_valyu_target(
    gateway_id="your-existing-gateway-id",
    region="us-east-1",
)
print(f"Target ID: {result['target_id']}")
Pros: Enterprise security, audit logging, centralized management Cons: Requires AWS infrastructure setup

Option 3: AgentCore Runtime

Full AWS-managed deployment with auto-scaling, streaming, and lifecycle management.
# Deploy to AgentCore Runtime
cd examples/runtime
agentcore configure --entrypoint agent.py --non-interactive --name valyuagent
agentcore launch
agentcore invoke '{"prompt": "What is NVIDIA stock price?"}'
Pros: Fully managed, auto-scaling, production-ready Cons: More complex setup, AWS costs

Tool Configuration

All tools support these configuration options:
from valyu_agentcore import financeSearch

tool = financeSearch(
    api_key="val_xxx",           # Valyu API key (or use VALYU_API_KEY env var)
    search_type="all",           # "all", "web", "proprietary", or "news"
    max_num_results=10,          # Number of results (default: 5)
    max_price=0.50,              # Max cost per query in CPM
    relevance_threshold=0.7,     # Quality filter (0-1)
    excluded_sources=["reddit.com"],     # Domains to exclude
    included_sources=["reuters.com"],    # Restrict to specific domains
    category="quarterly earnings",       # Natural language search context
)

Enterprise Use Cases

Financial Analyst Agent

Build an investment research assistant that analyzes companies across multiple data sources:
from valyu_agentcore import financeSearch, secSearch, webSearch
from strands import Agent
from strands.models import BedrockModel

FINANCIAL_ANALYST_PROMPT = """You are a senior financial analyst at a top investment firm.

When analyzing a company:
1. Use financeSearch for stock prices, earnings, and financial metrics
2. Use secSearch for 10-K/10-Q filings, risk factors, and disclosures
3. Use webSearch for recent news and market sentiment

Structure your analysis with:
- Executive Summary
- Financial Performance
- Key Risks
- Competitive Position
- Investment Thesis

Be specific with numbers and cite your sources."""

agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    system_prompt=FINANCIAL_ANALYST_PROMPT,
    tools=[financeSearch(), secSearch(), webSearch()],
)

response = agent("Analyze Apple's most recent quarterly earnings and outlook")

Research Assistant Agent

Literature review and academic research across multiple databases:
from valyu_agentcore import paperSearch, patentSearch, webSearch
from strands import Agent
from strands.models import BedrockModel

RESEARCH_ASSISTANT_PROMPT = """You are a research assistant specializing in technical literature review.

When researching a topic:
1. Use paperSearch for peer-reviewed academic papers (arXiv, PubMed)
2. Use patentSearch for prior art and IP landscape
3. Use webSearch for recent developments and news

Organize findings by:
- Key Papers (with citations)
- State of the Art
- Patent Landscape
- Recent Developments

Always cite sources with URLs."""

agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    system_prompt=RESEARCH_ASSISTANT_PROMPT,
    tools=[paperSearch(), patentSearch(), webSearch()],
)

response = agent("Survey recent advances in transformer architecture efficiency")

Due Diligence Agent

M&A and investment due diligence across financial, legal, and market data:
from valyu_agentcore import secSearch, financeSearch, webSearch, patentSearch
from strands import Agent
from strands.models import BedrockModel

DUE_DILIGENCE_PROMPT = """You are conducting due diligence for a potential investment or acquisition.

Generate a comprehensive report covering:
1. Company Overview - Use webSearch for background
2. Financial Analysis - Use financeSearch for metrics
3. Regulatory Filings - Use secSearch for SEC documents
4. IP Portfolio - Use patentSearch for patents
5. Market Position - Use webSearch for competitive analysis
6. Risk Factors - Synthesize from all sources

Be thorough and flag any red flags or concerns."""

agent = Agent(
    model=BedrockModel(model_id="us.anthropic.claude-sonnet-4-20250514-v1:0"),
    system_prompt=DUE_DILIGENCE_PROMPT,
    tools=[secSearch(), financeSearch(), webSearch(), patentSearch()],
)

response = agent("Conduct due diligence on Anthropic for a potential investment")

AWS Infrastructure

CloudFormation Deployment

Deploy the complete infrastructure stack with one command:
aws cloudformation create-stack \
  --stack-name valyu-agentcore \
  --template-body file://cloudformation/valyu-gateway.yaml \
  --parameters \
    ParameterKey=ValyuApiKey,ParameterValue=your-api-key \
    ParameterKey=GatewayName,ParameterValue=valyu-search-gateway \
  --capabilities CAPABILITY_IAM
Resources Created:
  • IAM Role for Gateway
  • Cognito User Pool with OAuth
  • Cognito App Client (client_credentials flow)
  • Secrets Manager secret for API key
  • CloudWatch Log Group (30-day retention)

IAM Policies

Full Access (for administrators):
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:*",
        "cognito-idp:*"
      ],
      "Resource": "*"
    }
  ]
}
Invoke-Only (for applications):
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:InvokeGateway",
        "bedrock-agentcore:ListTools"
      ],
      "Resource": "*"
    }
  ]
}

Security Best Practices

1

Use Environment Variables

Never hardcode API keys. Use VALYU_API_KEY environment variable or AWS Secrets Manager.
2

Enable CloudTrail

Monitor all API calls with CloudTrail for audit compliance and security monitoring.
3

Use OAuth for Production

Deploy with AgentCore Gateway for Cognito-based authentication in production environments.
4

Apply Least Privilege

Use invoke-only IAM policies for applications that only need to call the gateway.
5

Rotate Credentials

Regularly rotate Valyu API keys and Cognito client secrets.

Troubleshooting

Common Issues

Install with Strands support:
pip install "valyu-agentcore[strands]"
Gateway targets take ~2 minutes to sync. The add_valyu_target() function waits automatically. If it times out, check the Gateway status in the AWS console.
Ensure your Cognito client has the correct scope (gateway-name/invoke) and the client_credentials grant type is enabled.
Ensure you have access to the Bedrock model in your AWS account. Request access in the AWS Bedrock console if needed.

API Reference

Tool Functions

FunctionDescription
webSearch()General web and news search
financeSearch()Financial data, stocks, crypto, forex
paperSearch()Academic papers (arXiv, PubMed)
bioSearch()Biomedical research and clinical trials
patentSearch()USPTO patent search
secSearch()SEC filings and disclosures
economicsSearch()Economic indicators and data

ValyuTools Class

MethodReturns
ValyuTools.all()All 7 search tools
ValyuTools.financial_tools()financeSearch, secSearch, economicsSearch
ValyuTools.research_tools()paperSearch, bioSearch, patentSearch

Gateway Functions

FunctionDescription
setup_valyu_gateway()Create new Gateway + Cognito resources
add_valyu_target()Add Valyu to existing Gateway
cleanup_valyu_gateway()Remove all created resources
GatewayAgent.from_config()Create agent from saved config

Additional Resources

Pricing

Valyu charges per query based on the data sources accessed. With AWS AgentCore, you pay:
  • Valyu API costs — Per-query pricing based on data sources (see Pricing)
  • AWS costs — AgentCore Gateway, Cognito, CloudWatch (standard AWS rates)

Start Building Today

Get $10 free credits with no credit card required. Deploy production-ready AI agents in minutes.