Browse documentation
Get started
Give your agent Google Search and YouTube tools. Connect your host, then ask for your first result.
On this page
1. Connect and sign in
Choose Codex or OpenClaw for browser-based OAuth. For another host, choose Remote / API key if it supports Streamable HTTP and custom headers, or Local / stdio if it launches MCP processes. The hosted server needs no local installation.
Merge the config below into ~/.codex/config.toml, then run the login command. Complete FlashData signup or sign-in and consent in the browser. Start a fresh Codex session after login.
[mcp_servers.flashdata]
url = "https://data.flashdata.dev/mcp"
[mcp_servers.flashdata.oauth]
client_id = "flashdata-codex"
callback_url = "http://127.0.0.1/callback"codex mcp login flashdata --scopes mcp:researchRun these commands in the OpenClaw profile your agent uses. Complete signup or sign-in and consent in the browser, then start a fresh session. The doctor probe checks the saved connection.
openclaw mcp set flashdata '{"url":"https://data.flashdata.dev/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"mcp:research","clientMetadataUrl":"https://api.flashdata.dev/oauth/clients/openclaw.json"}}'
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probeCreate a key with Google Search permission, or reuse one. Add a server in your host's MCP settings using the fields below. Put the key in its protected header field and reconnect; no OAuth command is needed.
Name: flashdata
Transport: Streamable HTTP
URL: https://data.flashdata.dev/mcp
Header: X-API-Key: YOUR_API_KEYRequires Node.js 22.18+ and an API key with Google Search permission. Merge this into a host that supports mcpServers JSON. Replace YOUR_API_KEY in its local protected configuration, then restart the host. Use npx.cmd on Windows if the host requires an executable filename.
The pinned npm package runs the local MCP server. The standalone FlashData CLI is a separate executable.
{
"mcpServers": {
"flashdata": {
"command": "npx",
"args": [
"--yes",
"--package=@flashdata-dev/[email protected]",
"flashdata-mcp"
],
"env": {
"FLASHDATA_API_KEY": "YOUR_API_KEY"
}
}
}
}2. Check the connection
Send this in a fresh agent session. Expect successful get_pricing and get_balance calls, an available price for google_search and your available credit balance. A zero balance means you need credits for the search; it does not mean authentication failed.
Use the existing flashdata MCP connection.
Call get_pricing with {"source":"google_search","request_count":1}.
Call get_balance with {}.
Report whether both calls succeeded, whether the source has an available price,
and the available credit balance. A zero balance is not an authentication failure.
Do not run a search or download, create a trial, or change credentials.3. Ask for your first task
Paste this into your connected agent. The balance and pricing checks are free; the search uses account credits.
Use FlashData to check my balance and the price of one Google search. If there are enough credits, call google_search once with query "battery recycling research", num 5 and mode "realtime". Return titles, source URLs, short excerpts and actual credits used. Stop after this task.Check the result
Your agent should return source links and excerpts, plus the actual credits used. The underlying search result has status: done and results[].organic. An empty result is valid; the agent should report it. The example below is illustrative.
Completed one Google search.
1. Battery recycling research — https://example.org/recycling
An example search excerpt.
Credits used: 0.02Available tools
API-key calls use the permissions granted to that key. Discover the server's tools and input schemas for the full current catalog.
| Task | Tool | Access |
|---|---|---|
| Search Google | google_search | mcp:research / API key |
| Find YouTube videos | youtube_search | mcp:research / API key |
| Read video metadata | youtube_metadata | mcp:research / API key |
| Retrieve existing captions | youtube_transcript | mcp:research / API key |
| Download video or audio | youtube_download | Owner API key + destination storage |
| Check account and pricing | get_balance, get_pricing, get_limits, get_usage | Free account reads |
About OAuth, permissions and trials
OAuth connects your verified owner account and lets the host store and refresh tokens. The mcp:research grant covers the four research sources above. API-key connections use a protected X-API-Key header and can include other authorized sources.
To try FlashData before creating an account, use the CLI trial flow. MCP OAuth connects an owner account; it does not register or claim a trial. A CLI profile is not automatically shared with your MCP host.
Troubleshooting
| Problem | Try this |
|---|---|
| No FlashData tools | Finish consent, reconnect and start a fresh session. Check the URL and Streamable HTTP transport. |
| invalid_client / callback error | For Codex or OpenClaw, use its exact client configuration and a browser that can reach the local callback. For another host, use its supported API-key or stdio setup above. |
| 401 | Reconnect expired or revoked OAuth access, or check the API key supplied to the host. Repeat the free check. |
| 403 | Check the requested source and key permissions. YouTube Download requires an owner API key with youtube_download and destination storage; mcp:research does not include it. |
| 402 | Check Billing and the current price. Reconnecting a valid credential does not add credits. |
| 429 | Follow Retry-After. Keep any existing job or result ID before deciding whether to retry the task. |
| Timeout or incomplete response | Keep the request ID and check History. Read large-result continuations with get_result instead of repeating the search. |