Agent skill

BlockRun Phone and Voice

by BlockRunAI in BlockRunAI/blockrun-mcp

Looks up phone numbers for carrier and SIM-swap fraud signals, leases numbers and places AI outbound voice calls through BlockRun's local gateway.

MITAuto-check passedBackend & APIs

Install BlockRun Phone and Voice

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

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

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

At a glance

Looks up phone numbers for carrier and SIM-swap fraud signals, leases numbers and places AI outbound voice calls through BlockRun's local gateway.

  • Works in 4 steps: Triage an inbound number for fraud → Spin up a US number with a 415 area code → Confirm an appointment via AI voice call → …
  • Checking whether a phone number is mobile, landline or VoIP
  • SKILL.md covers How to Call from MCP, Endpoint Catalog, Voice Call Body Fields and Voice Presets, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill works through ClawRouter's local proxy, with payment made automatically from the user's BlockRun wallet through x402. A lookup returns carrier, line type and country; a fraud check adds SIM-swap recency and call-forwarding signals and is meant to run before sending sensitive SMS codes or starting account recovery. Wallet-owned numbers are leased for 30 days, can be bought in the US or Canada, renewed, listed and released, and can serve as caller ID.

Outbound AI voice calls go through Bland.ai, with slash and CLI shortcuts and tools for call status. A warning stresses that placing a call has real-world effects, so it should happen only when you explicitly asked for one, and the server blocks emergency numbers. Each gateway request is charged to the wallet individually.

When your agent uses it

  • Checking whether a phone number is mobile, landline or VoIP
  • Screening a number for SIM-swap risk before account recovery
  • Leasing a US or Canadian number to use as caller ID
  • Placing an AI-powered outbound call after explicit approval

Example prompts

  • “Look up the carrier and line type for +14155552671.”
  • “Run a fraud check on that number before I send the login code.”
  • “Buy a US number with a 415 area code.”
  • “Check the status of the call you placed.”

Requirements

  • A funded BlockRun wallet for x402 payments
  • ClawRouter running locally

Workflow steps

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

  1. Triage an inbound number for fraud
  2. Spin up a US number with a 415 area code
  3. Confirm an appointment via AI voice call
  4. List your wallet's leased numbers + release one

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

BlockRun Phone and Voice loads about 1.9k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 603 words of instructions outside code blocks.

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

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). 603 words, ~1,890 tokens.

Download SKILL.mdSave it as .claude/skills/phone/SKILL.md (or your agent's skills folder).
name
phone
description
Use when the user wants phone-number intelligence (lookup, carrier, line type, SIM-swap / call-forwarding fraud signals), US/CA number provisioning (rent a phone number), or outbound AI voice calls (Bland.ai under the hood — schedule, confirm, follow-up). Pay per call in USDC.
triggers
phone lookup, carrier lookup, phone number intelligence, sim swap, call forwarding, phone fraud, buy phone number, rent phone number, us phone number, ai…

Phone & Voice

Two namespaces in one tool: /v1/phone/* for number intelligence + provisioning, /v1/voice/* for outbound AI calls. Pay per call in USDC. Any other path is refused before payment — the tool never reaches routes outside these two.

Phone numbers use E.164 format — + followed by country code and subscriber digits (US: +1 + 10 digits; UK: +44 + 10 digits; etc.). The examples below use <+E.164-number> as a placeholder — the LLM should substitute the actual number from the user's request, not copy the literal placeholder.

How to Call from MCP

ts
const targetNumber = "<+E.164-number-from-user>"  // e.g. user said "call my doctor at 415-..."

// Lookup carrier + line type
blockrun_phone({ path: "phone/lookup", body: { phoneNumber: targetNumber } })

// Buy a 30-day US number
blockrun_phone({ path: "phone/numbers/buy", body: { country: "US", areaCode: "415" } })

// Outbound AI call (requires `from` — see below)
const r = await blockrun_phone({ path: "voice/call", body: {
  to: targetNumber,
  from: "<+E.164-number-you-own>",       // from phone/numbers/buy
  task: "Confirm appointment for Friday at 3pm with Dr. Wong.",
  voice: "june"
}})
// poll the result (free GET, no body)
blockrun_phone({ path: `voice/call/${r.call_id}` })

Endpoint Catalog

Phone intelligence + numbers (/v1/phone/*)
PathBodyPriceEffect
phone/lookup{ phoneNumber }$0.0110Carrier, line type (mobile/landline/VoIP)
phone/lookup/fraud{ phoneNumber }$0.0510+ SIM-swap signals, call-forwarding detection
phone/numbers/buy{ country?: "US"|"CA", areaCode? }$5.00130-day lease, US or CA
phone/numbers/renew{ phoneNumber }$5.001Extend lease 30 days
phone/numbers/list{}$0.0020Your wallet-owned numbers
phone/numbers/release{ phoneNumber }freeReturn to pool
Outbound AI calls (/v1/voice/*)
PathMethodBodyPrice
voice/callPOST{ to, task, from, voice?, max_duration?, language?, first_sentence?, wait_for_greeting? }$0.5410 flat
voice/call/{call_id}GET (no body)–free poll

from is REQUIRED and must be a number your wallet owns. Provision one first with phone/numbers/buy ($5, 30-day lease). 400 errors from voice/call are almost always missing from.

Voice Call Body Fields

FieldRequiredDefaultNotes
toyes–Destination E.164 number
taskyes–What the AI should do on the call (10–4000 chars)
fromyes–Your provisioned BlockRun caller-ID number (from phone/numbers/buy)
voicenonatnat / josh / maya / june / paige / derek / florian
max_durationno5Minutes, 1–30
languagenoen-USLanguage code, BCP-47
first_sentenceno–Custom opening line for the AI
wait_for_greetingnofalseLet recipient speak first, then AI starts

Voice Presets

VoiceTone
natNeutral / professional male, default
joshFriendly male
mayaWarm female
juneCalm professional female
paigeEnergetic female
derekDeep male
florianEuropean-accented male

Worked Examples

1. Triage an inbound number for fraud
ts
blockrun_phone({ path: "phone/lookup/fraud", body: { phoneNumber: "+14155550150" } })

Returns carrier, line type, SIM-swap indicator, call-forwarding state. Cost: $0.0510.

2. Spin up a US number with a 415 area code
ts
blockrun_phone({ path: "phone/numbers/buy", body: { country: "US", areaCode: "415" } })
// returns { phoneNumber: "+14155550199", expires_at: "..." }

Best-effort area code match. Cost: $5.001 for 30 days.

3. Confirm an appointment via AI voice call
ts
// Step 0 (one-time): provision a number you'll use as caller ID
const { phoneNumber: myNumber } = await blockrun_phone({
  path: "phone/numbers/buy", body: { country: "US", areaCode: "415" }
})  // $5.001, 30-day lease

// Step 1: place the call (from is REQUIRED)
const r = await blockrun_phone({ path: "voice/call", body: {
  to: "+14155550100",
  from: myNumber,
  task: "Call Dr. Wong's office. Confirm the appointment for Sarah Chen on Friday May 24th at 3pm. If the time isn't available, ask for the next opening on Friday afternoon and report back.",
  voice: "june",
  max_duration: 5,
  wait_for_greeting: true
}})
// returns { call_id: "call_abc..." } — call runs async

// Poll until done
while (true) {
  const status = await blockrun_phone({ path: `voice/call/${r.call_id}` })
  if (status.status === "completed") {
    console.log(status.summary, status.transcript)
    break
  }
  await new Promise(r => setTimeout(r, 5000))
}

Cost: $0.5410 flat for the call. Status polling is free.

4. List your wallet's leased numbers + release one
ts
const { numbers } = await blockrun_phone({ path: "phone/numbers/list", body: {} })
// Release the oldest
await blockrun_phone({ path: "phone/numbers/release", body: { phoneNumber: numbers[0].phoneNumber } })
Show full SKILL.md (244 more words)Show less

Best Practices

  • Always include task context the AI can act on. "Confirm appointment" is vague; "Confirm Sarah Chen's appointment for Friday May 24 at 3pm with Dr. Wong" is actionable.
  • Use wait_for_greeting: true for human-answered calls (most cases). Set to false for known-IVR / known-bot destinations to skip the greeting wait.
  • max_duration is a hard cap — the call ends regardless of conversation state. Default 5 min covers most scripted tasks.
  • from matters for trust** — using a provisioned BlockRun number you own (from numbers/buy) makes the call look less spammy than a random caller ID.

When NOT to Use

  • High-volume autodialer / robocall workloads — pricing is per-call ($0.5410 each) which doesn't amortize like wholesale telephony
  • Receiving inbound calls — numbers/buy provisions a number but inbound routing is not exposed via MCP; use Bland directly
  • Two-way human-to-human calls — this is for AI-driven outbound; for real-time human bridging, use a SIP provider

Notes

  • phone/lookup is cheap reconnaissance; phone/lookup/fraud is 5× the price but adds SIM-swap + call-forwarding signals you can't get from a basic carrier lookup
  • Voice calls return immediately with a call_id; the call runs in the background. Always poll voice/call/{call_id} to get the transcript
  • The poll endpoint is free — poll as often as you want, but every 5s is plenty
  • Calls that fail upstream (recipient hangs up, no answer) still charge the flat $0.5410 — Bland's pricing model

Reference

  • Phone endpoints: POST /v1/phone/*
  • Voice endpoints: POST /v1/voice/call and GET /v1/voice/call/{call_id}
  • Upstream: number intelligence + provisioning is internal; voice calls are Bland.ai

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

Open the folder on GitHubat commit a7a9b3c

Compare with similar skills

BlockRun Phone and Voice 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.

BlockRun Phone and Voice compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
BlockRun Phone and Voice this skillBlockRunAI/blockrun-mcp392—~1.9kAutomated safety check: PassMIT
Kleros IPFS Uploadinternet-court/internet-court-skill6.4k—~4.9kAutomated safety check: NotesMIT
Venice API Keysveniceai/skills143—~3.8kAutomated safety check: PassMIT
Brigade Voice Callsspinabot/brigade11k—~288Automated safety check: PassMIT
Venice API Overviewveniceai/skills143—~3.5kAutomated safety check: PassMIT
Nevermined PaymentsLeoYeAI/openclaw-master-skills2.2k—~4.5kAutomated safety check: NotesMIT

Similar skills

  • Kleros IPFS Upload

    internet-court/internet-court-skill

    Uploads one Kleros-related file per paid request to IPFS through the Kleros x402 gateway for 0.01 USDC on Base, returning a CID that Kleros contracts can reference.

    6.4k GitHub stars~4.9k tokensUpdated 1 mo ago
    Backend & APIsAuto-check: notes
  • Venice API Keys

    veniceai/skills

    Manages Venice API keys through the /api_keys endpoints: create, list, update and revoke keys, set spending limits, and read rate limits.

    143 GitHub stars~3.8k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Brigade Voice Calls

    spinabot/brigade

    Starts and inspects phone calls through the Brigade voice-call plugin, using a CLI command or the voice_call tool, with Twilio, Telnyx, Plivo or a mock provider.

    11k GitHub stars~288 tokensUpdated 4 days ago
    Productivity & AutomationAuto-check passed
  • Venice API Overview

    veniceai/skills

    High-level map of the Venice.ai API: base URL, auth modes per endpoint, endpoint categories, response headers, pricing model, error shape and versioning.

    143 GitHub stars~3.5k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Nevermined Payments

    LeoYeAI/openclaw-master-skills

    Integrates Nevermined payment infrastructure into AI agents, MCP servers, Google A2A agents, and REST APIs.

    2.2k GitHub stars~4.5k tokensUpdated 2 mo ago
    Backend & APIsAuto-check: notes
  • Birdeye DeFi Market Data

    internet-court/internet-court-skill

    Queries the Birdeye API for token prices, OHLCV candles, trending and new tokens, holder data, security checks and wallet P&L, with WebSocket streams for live prices and whale alerts.

    6.4k GitHub starsUsed in 1 repo~3.8k tokens
    Business, Finance & HRAuto-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

Works with

Questions about BlockRun Phone and Voice

What does BlockRun Phone and Voice do?

Looks up phone numbers for carrier and SIM-swap fraud signals, leases numbers and places AI outbound voice calls through BlockRun's local gateway. The skill works through ClawRouter's local proxy, with payment made automatically from the user's BlockRun wallet through x402. A lookup returns carrier, line type and country; a fraud check adds SIM-swap recency and call-forwarding signals and is meant to run before sending sensitive SMS codes or starting account recovery.

When should I use BlockRun Phone and Voice?

BlockRun Phone and Voice fits situations like: checking whether a phone number is mobile, landline or VoIP; screening a number for SIM-swap risk before account recovery; leasing a US or Canadian number to use as caller ID; placing an AI-powered outbound call after explicit approval.

How do I install BlockRun Phone and Voice in Claude Code?

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

How do I install BlockRun Phone and Voice in Codex?

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

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

What does BlockRun Phone and Voice need to run?

SKILL.md names no scripts, command-line tools or credentials: BlockRun Phone and Voice is instructions for the agent only. Our summary lists: A funded BlockRun wallet for x402 payments; ClawRouter running locally.

Does BlockRun Phone and Voice 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 BlockRun Phone and Voice 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 BlockRun Phone and Voice use?

BlockRun Phone and Voice 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 BlockRun Phone and Voice use?

About 1.9k tokens (SKILL.md is roughly 7.6k 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 BlockRun Phone and Voice?

Skills that share tags, products or a category with BlockRun Phone and Voice: Kleros IPFS Upload (internet-court/internet-court-skill, 6.4k stars), Venice API Keys (veniceai/skills, 143 stars), Brigade Voice Calls (spinabot/brigade, 11k stars) and Venice API Overview (veniceai/skills, 143 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains BlockRun Phone and Voice?

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.