Skip to main content
Give your coding agent the prompt below to install Valyu, sign in and verify a first search. It sets up the CLI for the agent you already use. To connect a chat app instead, use Valyu in Claude or ChatGPT.

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. If a link does not open your client, copy the prompt into it instead.

​
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 CLI agent integration.
5

Runs a real research task

After setup, ask the agent to run a research task you choose. Specify the scope and output you want, review the mode and expected charges, then inspect the resulting report and sources.

​
Prefer to do it yourself

CLI

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

Remote MCP

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

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.
New accounts get $10 free credits ($20 with a company email). While they last, you can use every source on the standard plans, including SEC filings, patents and genomics. After that, specialist sources depend on your plan. Check your balance before running a paid task, and see pricing for plans and usage charges.