Agent skill

Search

by BlockRunAI in BlockRunAI/blockrun-mcp

A skill your agent uses when the user wants real-time web or news results with AI-summarized answers and citations — Grok Live Search via BlockRun.

MITAuto-check passed

Install Search

skills CLI
$ npx skills add BlockRunAI/blockrun-mcp --skill search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BlockRunAI/blockrun-mcp search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BlockRunAI/blockrun-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/search .claude/skills/search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
search
GitHub stars
392
Token cost
~970 tokens
SKILL.md length
399 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants real-time web or news results with AI-summarized answers and citations — Grok Live Search via BlockRun.

  • Works in 3 steps: "What's the latest on the ETH ETF… → "What happened in Solana's latest outage?" → "Background on Pectra upgrade, last 90…
  • The user wants real-time web
  • SKILL.md covers How to Call from MCP, Body Shape, When to Reach for Which Source and Worked Examples, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Search is an agent skill from BlockRunAI/blockrun-mcp. Use when the user wants real-time web or news results with AI-summarized answers and citations — Grok Live Search via BlockRun. Cheapest path for "what just happened" questions where freshness beats neural-semantic ranking.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Live data for AI agents — search, research, markets, crypto, X/Twitter. Pay-per-call via x402 micropayments. The licence is MIT.

When your agent uses it

  • The user wants real-time web
  • News results with AI-summarized answers and citations — Grok Live Search via BlockRun

Example prompts

  • “what just happened”
  • “/search”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. "What's the latest on the ETH ETF approval timeline?"
  2. "What happened in Solana's latest outage?"
  3. "Background on Pectra upgrade, last 90 days only"

What it can do on your machine

Read from SKILL.md and the folder at commit a7a9b3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Search loads about 970 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 399 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~970

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BlockRunAI/blockrun-mcp at commit a7a9b3c, republished under its MIT licence (© BlockRunAI). 399 words, ~970 tokens.

Download SKILL.mdSave it as .claude/skills/search/SKILL.md (or your agent's skills folder).
name
search
description
Use when the user wants real-time web or news results with AI-summarized answers and citations — Grok Live Search via BlockRun. Cheapest path for "what just happened" questions where freshness beats neural-semantic ranking.
triggers
live search, grok live, what just happened, real time news, breaking news, today's news, search with citations, cited search, news search

Live Search (Grok)

Real-time web + news search with AI-summarized results and citations. PRICED PER SOURCE and expensive by default: $0.025 × max_results, +5% +$0.001 → default 10 settles $0.2635 per call. Best for fresh queries; for semantic / neural research use blockrun_exa instead.

How to Call from MCP

ts
blockrun_search({ body: {
  query: "what's the consensus on the Fed's next move",
  sources: ["web", "news"],
  max_results: 10
}})

Body Shape

FieldRequiredTypeNotes
queryyesstringNatural-language search query
sourcesnostring[]Subset of ["web","news"]. Default: ["web"] — pass both for news coverage. There is no X/Twitter source (removed upstream 2026-07-05; asking for "x" is refused before payment). Does NOT multiply price.
max_resultsnonumber1–50, default 10. Drives the price — ~$0.0263 charged per source. Pass a small number to cap spend; the gateway prices the raw value and does not floor fractions.
from_datenostringYYYY-MM-DD lower bound on result date
to_datenostringYYYY-MM-DD upper bound

When to Reach for Which Source

User intentsources setting
Breaking news / today's headlines["news"]
Social / X sentimentnot served — there is no X source; use ["news","web"] and say so, or blockrun_exa for a targeted crawl
Backgrounder / explainer / docs["web"]
General "find current info" question["web","news"] (omitting it searches the web only)

Worked Examples

1. "What's the latest on the ETH ETF approval timeline?"
ts
blockrun_search({ body: { query: "Ethereum ETF approval SEC", sources: ["news","web"], max_results: 8 } })

Cost: ~$0.2110 (8 sources: $0.025 × 8 × 1.05 + $0.001).

2. "What happened in Solana's latest outage?"
ts
blockrun_search({ body: { query: "Solana outage today", sources: ["news","web"], max_results: 15 } })

Cost: ~$0.3948 (15 sources: $0.025 × 15 × 1.05 + $0.001). There is no X/Twitter source: sources: ["x"] is refused before payment with the live list, so do not promise "what X is saying" — say what the news and web say.

Show full SKILL.md (147 more words)Show less
3. "Background on Pectra upgrade, last 90 days only"
ts
blockrun_search({ body: {
  query: "Ethereum Pectra upgrade",
  sources: ["web","news"],
  from_date: "2026-02-17"
}})

Cost: $0.2635 (10 sources, the default — verified live).

search vs exa — Pick the Right Tool

Use caseTool
"What's happening right now?" — freshness mattersblockrun_search
"Find the canonical paper on X" — semantic relevance mattersblockrun_exa
"Pull the full text of these 5 URLs" — content fetchblockrun_exa contents
"Cited answer to a question"both work; blockrun_exa answer is grounded in pre-indexed corpus, blockrun_search searches the live web

Notes

  • Returns AI-summarized text + a list of sources with URLs. The summary is one paragraph; sources let you drill in.
  • Price is per result, not per source. max_results: 20 with one source or three sources both charge $0.526 ($0.025 × 20 × 1.05 + $0.001 — verified live). Pass a smaller max_results to cap spend.
  • Date filters are strict — results outside the window are dropped, not down-ranked.

Reference

  • Endpoint: POST /v1/search
  • Upstream: xAI Grok Live Search

© BlockRunAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/search of BlockRunAI/blockrun-mcp.

Open the folder on GitHubat commit a7a9b3c

Compare with similar skills

Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Search this skillBlockRunAI/blockrun-mcp392—~970Automated safety check: PassMIT
Content Research Writerweapp-tailwindcss/weapp-tailwindcss1.9k25 repos~3.5kAutomated safety check: PassMIT
NetworkxzLanqing/codex-claude-academic-skills4.6k16 repos~3.2kAutomated safety check: PassBSD-3-Clause
Citation Verification GuideGalaxy-Dawn/claude-scholar5.7k3 repos~1.9kAutomated safety check: PassMIT
Systematic Review ScreenerImbad0202/academic-research-skills51k—~8.4kAutomated safety check: PassCustom licence
Literature Reviewneflibata-feng/MyArxiv-Agent12621 repos~5.9kAutomated safety check: NotesMIT

Similar skills

  • Content Research Writer

    weapp-tailwindcss/weapp-tailwindcss

    Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section.

    1.9k GitHub starsUsed in 25 repos~3.5k tokens
    Research & ScienceAuto-check passed
  • Networkx

    zLanqing/codex-claude-academic-skills

    Comprehensive toolkit for creating, analyzing, and visualizing complex networks and graphs in Python.

    4.6k GitHub starsUsed in 16 repos~3.2k tokens
    Research & ScienceAuto-check passed
  • Citation Verification Guide

    Galaxy-Dawn/claude-scholar

    Reference guidance for checking every citation in academic writing against canonical sources such as DOI, arXiv, CrossRef and Semantic Scholar, to catch fake or wrong references.

    5.7k GitHub starsUsed in 3 repos~1.9k tokens
    Research & ScienceAuto-check passed
  • Systematic Review Screener

    Imbad0202/academic-research-skills

    Screens records for systematic, scoping and rapid reviews against fixed eligibility rules, using two blinded AI reviewers and a third adjudicator, with traceable PRISMA counts.

    51k GitHub stars~8.4k tokensUpdated 4 days ago
    Research & ScienceAuto-check passed
  • Literature Review

    neflibata-feng/MyArxiv-Agent

    Conduct comprehensive, systematic literature reviews using multiple academic databases (PubMed, arXiv, bioRxiv, Semantic Scholar, etc.).

    126 GitHub starsUsed in 21 repos~5.9k tokens
    Research & ScienceAuto-check: notes
  • Openalex Database

    neflibata-feng/MyArxiv-Agent

    Query and analyze scholarly literature using the OpenAlex database.

    126 GitHub starsUsed in 13 repos~3k tokens
    Research & ScienceAuto-check passed

More from BlockRunAI/blockrun-mcp

All 17 skills in this repo
  • Signal To Trade Demo

    BlockRunAI/blockrun-mcp

    Prepare or run a polished BlockRun trading demo that discovers a current Polymarket market, combines live price, probability history, smart-money, and liquidity evidence into a balanced signal…

    392 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Blockrun

    BlockRunAI/blockrun-mcp

    Pay-per-call access to AI models, real-time data, media generation and multi-chain RPC over x402 micropayments (USDC on Base or Solana), or a BlockRun account API key.

    392 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Debug

    BlockRunAI/blockrun-mcp

    A skill your agent uses when the BlockRun MCP server (@blockrun/mcp) is installed but misbehaving — 'Failed to connect', spawn npx ENOENT, blockrun missing from claude mcp list, HTTP 402 /…

    392 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Setup

    BlockRunAI/blockrun-mcp

    A skill your agent uses when asked to install, add, configure, or set up the BlockRun MCP server (@blockrun/mcp) in Claude Code, Claude Desktop, Cursor, Windsurf, Codex CLI, Grok or another MCP…

    392 GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Blockrun Upgrade

    BlockRunAI/blockrun-mcp

    A skill your agent uses when the BlockRun MCP server prints 'Update available', when asked to upgrade, update, or pin @blockrun/mcp, when a fix 'should be in the new version' but the client still…

    392 GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Crypto Data

    BlockRunAI/blockrun-mcp

    A skill your agent uses for any crypto data question — token/coin prices, FX, commodities, stocks, OHLC history, DEX pairs and liquidity, DeFi TVL, yield/APY pools, or raw JSON-RPC against a chain…

    392 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed

Questions about Search

What does Search do?

A skill your agent uses when the user wants real-time web or news results with AI-summarized answers and citations — Grok Live Search via BlockRun. Search is an agent skill from BlockRunAI/blockrun-mcp. Use when the user wants real-time web or news results with AI-summarized answers and citations — Grok Live Search via BlockRun.

When should I use Search?

Search fits situations like: the user wants real-time web; news results with AI-summarized answers and citations — Grok Live Search via BlockRun.

How do I install Search in Claude Code?

Run `npx skills add BlockRunAI/blockrun-mcp --skill search -a claude-code`. Or copy the skill folder (skills/search in BlockRunAI/blockrun-mcp) into .claude/skills/search in your project. Claude Code loads it when a task matches its description.

How do I install Search in Codex?

Run `npx skills add BlockRunAI/blockrun-mcp --skill search -a codex`. Or copy the skill folder (skills/search in BlockRunAI/blockrun-mcp) into .agents/skills/search in your project. Codex loads it when a task matches its description.

Can I use Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BlockRunAI/blockrun-mcp --skill search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/search, .gemini/skills/search, .github/skills/search and .opencode/skills/search in your project.

What does Search need to run?

SKILL.md names no scripts, command-line tools or credentials: Search is instructions for the agent only.

Does Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Search use?

Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Search use?

About 970 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Search?

Skills that share tags, products or a category with Search: Content Research Writer (weapp-tailwindcss/weapp-tailwindcss, 1.9k stars), Networkx (zLanqing/codex-claude-academic-skills, 4.6k stars), Citation Verification Guide (Galaxy-Dawn/claude-scholar, 5.7k stars) and Systematic Review Screener (Imbad0202/academic-research-skills, 51k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Search?

BlockRunAI (a GitHub organization) maintains it in BlockRunAI/blockrun-mcp, which has 392 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

Source: BlockRunAI/blockrun-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.