Skip to main content
Best for: getting started fast. Instead of reading these docs and copying an API key into a terminal, give the prompt below to the coding agent you already have open and let it do the setup. It covers the CLI - for chat clients see Remote MCP, and for building Valyu into a product see the SDKs.

Copy this into any coding agent. It fetches the runbook and does the rest.

Open in Cursor
These agents publish a URL scheme that carries a prompt, so one click opens them with the line above already typed. Nothing is auto-sent - you still press Enter.
Open in Claude Code↗Open in Codex↗Open in Cursor↗View agents.md↗
Deep links need the agent installed locally with its URL handler registered. OpenCode, Gemini CLI, Copilot, Windsurf, Hermes, Amp, Zed, Warp, Kiro, and LM Studio do not currently publish a URL scheme that carries a prompt - copy the prompt and paste it in instead. Same outcome.

​
What the agent actually does

Working through valyu.ai/agents.md, the agent:
1

Installs the CLI

curl -fsSL https://get.valyu.ai | bash on macOS/Linux, or Homebrew, npm, or PowerShell. It checks for an existing install first rather than blindly reinstalling.
2

Runs the login flow

valyu login opens a browser device flow that mints a scoped key - there is nothing for you to copy and paste. With --json the CLI streams device_code, auth_waiting, and auth_success events, so the agent can show you the user code and tell you it is waiting on you.
3

Verifies before claiming success

valyu doctor and valyu account balance, then a single query against a source that works on every plan. The runbook tells the agent not to report success without this, and not to run paid DeepResearch tasks or top up your balance on its own.
4

Installs the skill

npx skills add @valyu/cli teaches the agent the full command surface, so it stops guessing at flags. See Agent Skills.
5

Runs a real research task

The runbook does not stop at “installed”. Your agent picks something useful from what it already knows about your work, runs it through DeepResearch with a deliverable attached, then downloads the PDF and spreadsheet and opens them, so you see the output rather than a description of it.

​
Prefer to do it yourself

CLI

Install, authenticate, and run search, content extraction, and deep research from your terminal.

Remote MCP

Hosted server with 11 tools. Drops into Claude, Cursor, or any MCP client.

Agent Skills

Skills for Claude Code, Cursor, Windsurf, and anything supporting skills.sh.

Quickstart

First API request in minutes with Python, TypeScript, or REST.

​
Agent-readable surfaces

Every surface here has a machine-readable form. Point an agent at these directly rather than scraping HTML.
The free signup credits cover web and open academic sources. SEC filings, patents, drug discovery, genomics, and advanced company financials need a plan, which also lowers your cost per credit. See pricing.