Agent skill

Exa Research

by BlockRunAI in BlockRunAI/blockrun-mcp

A skill your agent uses when researching products, finding academic papers, discovering competitors, reading webpage content, or getting cited answers grounded in real web sources.

MITAuto-check passedProductivity & Automation

Install Exa Research

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

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

GitHub CLI
$ gh skill install BlockRunAI/blockrun-mcp exa-research --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/exa-research .claude/skills/exa-research && 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
exa-research
GitHub stars
392
Token cost
~1.6k tokens
SKILL.md length
347 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when researching products, finding academic papers, discovering competitors, reading webpage content, or getting cited answers grounded in real web sources.

  • Works in 5 steps: Initialize (Python SDK) → Search — Find Relevant URLs → Answer — Cited, Grounded Response → …
  • Researching products
  • SKILL.md covers How to Call from MCP, Quick Decision Table, Python SDK Instructions and Common Research Workflows, plus 2 more sections
  • Calls pip; reaches arxiv.org and polymarket.com

What it does

Exa Research is an agent skill from BlockRunAI/blockrun-mcp. Use when researching products, finding academic papers, discovering competitors, reading webpage content, or getting cited answers grounded in real web sources. Use over generic search when semantic relevance matters.

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

It sits in Productivity & Automation, covering Web search. 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

  • Researching products
  • Finding academic papers
  • Discovering competitors
  • Reading webpage content

Example prompts

  • “/exa-research”

Requirements

  • Python 3

Workflow steps

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

  1. Initialize (Python SDK)
  2. Search — Find Relevant URLs
  3. Answer — Cited, Grounded Response
  4. Contents — Fetch URL Text
  5. Similar — Find Related Pages

What it can do on your machine

Read from SKILL.md and the folder at commit e9b2bd5. 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

    Shell commands in SKILL.md call:

    • pip

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • arxiv.org
    • polymarket.com
    • target-company.com

    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

Exa Research loads about 1.6k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 347 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
~1.6k

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 e9b2bd5, republished under its MIT licence (© BlockRunAI). 347 words, ~1,567 tokens.

Download SKILL.mdSave it as .claude/skills/exa-research/SKILL.md (or your agent's skills folder).
name
exa-research
description
Use when researching products, finding academic papers, discovering competitors, reading webpage content, or getting cited answers grounded in real web sources. Use over generic search when semantic relevance matters.
triggers
research, web research, find papers, academic papers, competitor discovery, find similar sites, exa search, cited answer, scrape webpage, neural search…

Exa Research

Neural web search via BlockRun. Understands meaning, not keywords. Four distinct actions for different research modes.

How to Call from MCP

As of v0.14.1 the blockrun_exa tool is path-based. Pass the endpoint name as path and the request as body:

ts
blockrun_exa({ path: "search",       body: { query: "AI agent frameworks 2026", numResults: 10 } })
blockrun_exa({ path: "answer",       body: { query: "What is speculative decoding?" } })
blockrun_exa({ path: "contents",     body: { urls: ["https://example.com/a", "https://example.com/b"] } })
blockrun_exa({ path: "find-similar", body: { url: "https://arxiv.org/abs/2401.12345", numResults: 5 } })

Quick Decision Table

Costs below are what you are actually CHARGED — the $0.001 transaction fee is already included (it applies once per call, not per result).

User wants...PathBodyCost
Relevant URLs on a topicsearch{ query, numResults?, category? }$0.0110/call
Cited answer to a questionanswer{ query }$0.0110/call
Full text of URLscontents{ urls: [...] }$0.002/URL + $0.001 → 1 URL $0.0030, 3 URLs $0.0070
Pages like a given URLfind-similar{ url, numResults? }$0.0110/call
Recent newssearch + category: "news"–$0.0110/call
Academic paperssearch + category: "research paper"–$0.0110/call
Company infosearch + category: "company"–$0.0110/call

contents bills per URL, so batching URLs into ONE call is markedly cheaper than one call each: 3 URLs together cost $0.0070, but three separate calls cost $0.0090 — you pay the flat fee three times instead of once.

Valid category values for search: "news", "research paper", "company", "tweet", "github", "pdf".

Python SDK Instructions

1. Initialize (Python SDK)
python
from blockrun_llm import setup_agent_wallet

chain = open(os.path.expanduser("~/.blockrun/.chain")).read().strip() if os.path.exists(os.path.expanduser("~/.blockrun/.chain")) else "base"
if chain == "solana":
    from blockrun_llm import setup_agent_solana_wallet
    client = setup_agent_solana_wallet()
else:
    from blockrun_llm import setup_agent_wallet
    client = setup_agent_wallet()
2. Search — Find Relevant URLs
python
# Basic search
result = client._request_with_payment_raw("/v1/exa/search", {
    "query": "AI agent frameworks 2025",
    "numResults": 10,
})
for r in result.get("results", []):
    print(f"{r['title']} — {r['url']}")

# Filter by category
result = client._request_with_payment_raw("/v1/exa/search", {
    "query": "transformer architecture improvements",
    "numResults": 10,
    "category": "research paper",
})

# Restrict to specific domains
result = client._request_with_payment_raw("/v1/exa/search", {
    "query": "prediction market regulation",
    "numResults": 10,
    "includeDomains": ["reuters.com", "bloomberg.com", "wsj.com"],
})

Categories: "news", "research paper", "company", "tweet", "github", "pdf"

3. Answer — Cited, Grounded Response

Use when the user asks a factual question and needs reliable sources (not Claude's training data).

python
result = client._request_with_payment_raw("/v1/exa/answer", {
    "query": "What is the current market cap of Polymarket?",
})
print(result.get("answer", ""))
for c in result.get("citations", []):
    print(f"  [{c.get('title')}] {c.get('url')}")
4. Contents — Fetch URL Text

Use when you have URLs and need their full text for LLM context (scraping without a browser).

python
urls = [
    "https://example.com/article-1",
    "https://example.com/article-2",
]
result = client._request_with_payment_raw("/v1/exa/contents", {
    "urls": urls,
})
for item in result.get("results", []):
    print(f"=== {item['url']} ===")
    print(item.get("text", "")[:500])

Up to 100 URLs per call. Returns Markdown-ready text.

Use to discover competitors, related research, or sites with similar content.

python
result = client._request_with_payment_raw("/v1/exa/find-similar", {
    "url": "https://polymarket.com",
    "numResults": 10,
})
for r in result.get("results", []):
    print(f"{r['title']} — {r['url']}")

Common Research Workflows

Competitor discovery:

python
# 1. Find similar companies
similar = client._request_with_payment_raw("/v1/exa/find-similar", {"url": "https://target-company.com", "numResults": 15})
urls = [r["url"] for r in similar.get("results", [])]

# 2. Fetch their about pages
contents = client._request_with_payment_raw("/v1/exa/contents", {"urls": urls[:10]})

Research synthesis:

python
# 1. Find papers
papers = client._request_with_payment_raw("/v1/exa/search", {
    "query": "your topic",
    "category": "research paper",
    "numResults": 20,
})

# 2. Get answer with citations
answer = client._request_with_payment_raw("/v1/exa/answer", {
    "query": "What are the key findings on your topic?",
})
Use blockrun_exa / _request_with_payment_rawUse client.search()
Finding specific URLs and fetching contentGetting a summarized answer with citations
Semantic similarity searchWeb + news combined
Academic paper discoveryCheaper per call for simple lookups
Domain-filtered researchAlready returns a SearchResult object

Requirements

  • BlockRun SDK: pip install blockrun-llm
  • USDC wallet funded (see client.get_balance())
  • _request_with_payment_raw is the Python SDK entry point for Exa (no dedicated method yet)

© 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/exa-research of BlockRunAI/blockrun-mcp.

Open the folder on GitHubat commit e9b2bd5

Compare with similar skills

Exa Research 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.

Exa Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Exa Research this skillBlockRunAI/blockrun-mcp392—~1.6kAutomated safety check: PassMIT
Brave Searchbadlogic/pi-skills2.6k6 repos~592Automated safety check: PassMIT
Enterprise AI Scenario MapMetaInFLow/Enterprise-ai-scenario-map-skill632—~1.8kAutomated safety check: PassMIT
Web Searchjjyaoao/HelloAgents3.2k1 repos~5.6kAutomated safety check: PassMIT
Ddg SearchTheSyart/claude-agent-examples4051 repos~493Automated safety check: PassNone
Local Web SearchuluckyXH/OpenMOSS1.3k—~392Automated safety check: NotesMIT

Similar skills

  • Brave Search

    badlogic/pi-skills

    Web search and content extraction via Brave Search API. An agent skill from badlogic/pi-skills.

    2.6k GitHub starsUsed in 6 repos~592 tokens
    Productivity & AutomationAuto-check passed
  • Enterprise AI Scenario Map

    MetaInFLow/Enterprise-ai-scenario-map-skill

    企业AI场景地图生成报告工具。通过 web-search 深度调研企业信息,按照V2.1标准模板生成结构化AI应用场景地图报告,包含企业画像、业务诊断、行业实践、AI场景全量表、实施路径等完整内容。

    632 GitHub stars~1.8k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check passed
  • Web Search

    jjyaoao/HelloAgents

    Implement web search capabilities using the z-ai-web-dev-sdk.

    3.2k GitHub starsUsed in 1 repo~5.6k tokens
    Productivity & AutomationAuto-check passed
  • Ddg Search

    TheSyart/claude-agent-examples

    Web search without an API key using DuckDuckGo Lite via webfetch.

    405 GitHub starsUsed in 1 repo~493 tokens
    Productivity & AutomationAuto-check passed
  • Local Web Search

    uluckyXH/OpenMOSS

    A skill your agent uses when the user asks for web search that should run via the local-160 Responses API with websearch tool (base URL like https://proxy.example.com, model gpt-5.2-codex(xhigh)).

    1.3k GitHub stars~392 tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check: notes
  • Web Search

    EXboys/skilllite

    Web search and content extraction with Tavily and Exa via inference.sh CLI.

    170 GitHub starsUsed in 3 repos~1k tokens
    Productivity & AutomationAuto-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 Exa Research

What does Exa Research do?

A skill your agent uses when researching products, finding academic papers, discovering competitors, reading webpage content, or getting cited answers grounded in real web sources. Exa Research is an agent skill from BlockRunAI/blockrun-mcp. Use when researching products, finding academic papers, discovering competitors, reading webpage content, or getting cited answers grounded in real web sources.

When should I use Exa Research?

Exa Research fits situations like: researching products; finding academic papers; discovering competitors; reading webpage content.

How do I install Exa Research in Claude Code?

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

How do I install Exa Research in Codex?

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

Can I use Exa Research 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 exa-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/exa-research, .gemini/skills/exa-research, .github/skills/exa-research and .opencode/skills/exa-research in your project.

What does Exa Research need to run?

Going by SKILL.md and its folder, Exa Research needs the command-line tools its instructions call (pip). Our summary lists: Python 3.

Does Exa Research access the network?

SKILL.md names 3 domains. In commands or code: arxiv.org, polymarket.com and target-company.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Exa Research 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 Exa Research use?

Exa Research 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 Exa Research use?

About 1.6k tokens (SKILL.md is roughly 6.3k 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 Exa Research?

Skills that share tags, products or a category with Exa Research: Brave Search (badlogic/pi-skills, 2.6k stars), Enterprise AI Scenario Map (MetaInFLow/Enterprise-ai-scenario-map-skill, 632 stars), Web Search (jjyaoao/HelloAgents, 3.2k stars) and Ddg Search (TheSyart/claude-agent-examples, 405 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Exa Research?

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 8, 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.