# Kairos Research

Kairos Research is a Claude Code MCP server for checking Base wallets and contracts, and converting web pages or PDFs to Markdown. Paid calls use x402 or prepaid credits.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: kairosfamilyagents-blip
- License: CC-BY-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kairosfamilyagents-blip/kairos-research
- Updated: 2026-11-07
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/kairos-research

## What it does

Kairos Research returns Base wallet details, including ETH balance, nonce, proxy slots, balances for 10 major Base tokens, and recent USDC/WETH transfers from roughly the past 24 hours. Its contract tool examines bytecode, Sourcify verification, and EIP-1967 proxy slots. Another tool turns a public web page or PDF into Markdown; it follows `robots.txt`, rejects private addresses, and stores nothing.

The remote MCP connection uses HTTP and requires no authentication; the `catalog` tool is free. Paid calls require USDC on Base through x402, or a key obtained with prepaid credits. Prices vary within fixed bounds; the README gives a range of $0.003 to $0.01 per call. Reports are AI-generated and are not financial advice.

## Requirements
- Remote server: `https://kairosfamilyagents.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http research https://kairosfamilyagents.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add kairos-research --url https://kairosfamilyagents.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kairos-research": {
            "url": "https://kairosfamilyagents.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kairos-research": {
            "type": "http",
            "url": "https://kairosfamilyagents.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http kairos-research https://kairosfamilyagents.com/mcp
```

## When to use it
- inspect a Base wallet's balance and transfers
- review a contract's bytecode and proxy slots
- convert a public web page or PDF to Markdown

## Example prompts
- Check Base wallet `0x...` and show its balance and transfers.
- Inspect Base contract `0x...`, including its bytecode and proxy slots.
- Turn this public page or PDF into Markdown.

## Similar
- [base-mcp](https://affpapa.org/en/nevibecode/skills/base-base-mcp.md) — skill · 516 installs
- [blockchain-developer](https://affpapa.org/en/nevibecode/agents/voltagent-blockchain-developer.md) — subagent · ★ 6505 repo stars
- [verdikta-bounties-onboarding](https://affpapa.org/en/nevibecode/skills/verdikta-bounties-onboarding.md) — skill · ★ 58 repo stars
- [Kipurse](https://affpapa.org/en/nevibecode/mcp/kipurse.md) — MCP server
- [NFT Metadata — Token Image, Attributes & Collection Info](https://affpapa.org/en/nevibecode/mcp/nft-metadata-token-image-attributes-collection-info.md) — MCP server · 6157 installs
- [AurelianFlo](https://affpapa.org/en/nevibecode/mcp/aurelianflo.md) — MCP server · 539 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
