BlockRunAIBlockRunAI/blockrun-mcp/AGENTS.md

blockrun-mcp

AGENTS.md389 starsChanged 23 days agoMITView on GitHub

MCP server giving Codex real-time data — markets, research, web search, crypto. Pay per call with USDC.

Installs packages

In this repository18 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- blockrun-debugSkill
- blockrun-setupSkill
- blockrunSkill
- blockrun-upgradeSkill
- crypto-dataSkill
- decideSkill
- exa-researchSkill
- gentech-blockrunSkill
- image-promptingSkill
- modalSkill
- phoneSkill
- polymarket-tradingSkill
- prediction-marketsSkill
- rpcSkill
- searchSkill
- signal-to-trade-demoSkill
- surfSkill

The file

Create a free account to mount

Files

AGENTS.md

BlockRun MCP

MCP server giving Codex real-time data — markets, research, web search, crypto. Pay per call with USDC.

Commands

npm install              # install dependencies
npm run build            # compile with tsup
npm run dev              # watch mode (tsx)
npm start                # start MCP server
npm run typecheck        # type checking

Project structure

src/
├── index.ts             # MCP server entry point
├── mcp-handler.ts       # MCP protocol handler
├── tools/               # MCP tool implementations
├── types.ts             # Type definitions
└── utils/               # Shared utilities

Key dependencies

@blockrun/llm — LLM gateway SDK (x402 payments)
@modelcontextprotocol/sdk — MCP protocol SDK
zod — Schema validation
viem — Ethereum interaction
qrcode — Wallet QR code display

Install in Codex

codex mcp add blockrun -- npx -y @blockrun/mcp@latest

Conventions

TypeScript, ESM
Build with tsup
Node >= 20.19
MIT license
npm registry: @blockrun/mcp

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free