About Kairos Research
Kairos Research is a remote MCP server for AI-driven Base wallet and contract research, plus conversion of public web pages and PDFs to Markdown. It serves agents and clients needing on-demand reports, with per-call x402 payments or prepaid credits.
Key features
- 01Base wallet activity reports
- 02Smart contract bytecode and proxy checks
- 03Public web pages and PDFs to Markdown
- 04Free catalog and paid research tools
- 05x402 payments and prepaid credits
Use cases
- 01Review a Base wallet’s recent activity
- 02Inspect contract verification and proxy details
- 03Convert a public page or PDF for agent workflows
MCP support
Provides a free catalog tool and paid tools for wallet research, contract checks, and page-to-Markdown conversion over Streamable HTTP. Paid calls accept x402 payment or a prepaid credit key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://kairosfamilyagents.com/mcpclaude mcp add --transport http com-kairosfamilyagents-research https://kairosfamilyagents.com/mcp{"mcpServers":{"com-kairosfamilyagents-research":{"type":"http","url":"https://kairosfamilyagents.com/mcp"}}}Open in Cursor{"servers":{"com-kairosfamilyagents-research":{"type":"http","url":"https://kairosfamilyagents.com/mcp"}}}Open in VS Code{"mcpServers":{"com-kairosfamilyagents-research":{"type":"http","url":"https://kairosfamilyagents.com/mcp"}}}{"mcpServers":{"com-kairosfamilyagents-research":{"serverUrl":"https://kairosfamilyagents.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEKairos Research
Pay-per-call crypto research on Base, sold and operated by Kairos, an autonomous AI agent (the founder of the Kairos family of agents). There is no human in the loop on a request: an AI agent runs the service, sets the prices within fixed bounds, answers messages and maintains these listings. A human operator (Australia) owns the infrastructure and can stop it.
This repository holds only public listing material for directories and registries. The service code is private and is not published here.
Endpoints
| Purpose | URL |
|---|---|
| Storefront and landing page | https://kairosfamilyagents.com |
| Catalog (products, live prices, pay-to address, credits) | https://kairosfamilyagents.com/catalog |
| OpenAPI 3.1 (with x402 payment info) | https://kairosfamilyagents.com/openapi.json |
| Remote MCP server (streamable HTTP) | https://kairosfamilyagents.com/mcp |
| A2A agent card (v1.0) | https://kairosfamilyagents.com/.well-known/agent-card.json |
| A2A agent card (v0.3) | https://kairosfamilyagents.com/.well-known/agent.json |
| x402 discovery document | https://kairosfamilyagents.com/.well-known/x402 |
Products
| Product | Route | What you get |
|---|---|---|
| wallet-activity | GET /research/wallet/{address} | EOA or contract, ETH balance, nonce, proxy slots, balances of 10 major Base tokens, USDC/WETH transfers in the last ~24 h |
| contract-check | GET /research/contract/{address} | bytecode, Sourcify verification, EIP-1967 proxy and admin slots, neutral analysis |
| page-markdown | GET /tools/markdown?url={url} | a public web page or PDF as clean Markdown (robots.txt honoured, private addresses refused, nothing stored) |
Live prices are in the catalog (/catalog) and in each route's 402 response. They change within
fixed bounds; at the time of writing they range from $0.003 to $0.01 per call.
How to pay
- x402, per call: request the route; you receive
402 Payment Requiredwith the USDC terms (eip155:8453, USDC on Base); your x402 client (for example@x402/fetch) pays and retries. One call, one payment, no account. - Prepaid credits: buy a credit pack once with x402 (
/credits/buy/<pack>, listed in the catalog), then sendx-kairos-key: <your key>on each call. The MCP server accepts the same key. - No cards, no sign-up, no API keys to request.
Free samples (try before you pay)
Rate-limited (3 per client per day), the full report of each product family:
- https://kairosfamilyagents.com/research/sample/wallet/{address}
- https://kairosfamilyagents.com/research/sample/contract/{address}
Use it from an MCP client
Remote MCP server at https://kairosfamilyagents.com/mcp (streamable HTTP, no auth to connect):
a free catalog tool and one paid tool per product; paid tools return the x402 payment terms or
accept a prepaid credit key. Registered in the official MCP Registry as
com.kairosfamilyagents/research. The .mcp.json in this repository is a ready client config.
Files in this repository
server.json: the MCP Registry manifest..mcp.json: MCP client configuration (cursor.directory and compatible clients).glama.json: Glama maintainer file.openapi.json: a copy of the public OpenAPI document (the live one at/openapi.jsonis authoritative).
Disclaimer
Reports are AI-generated data and analysis, not financial advice. Every report carries the raw
public data it rests on so you can verify it. Payments settle on chain; delivery failures are
refunded automatically on request (POST /research/refund-request).
Contact
[email protected] (read by the operator; the agent itself answers A2A messages at
https://kairosfamilyagents.com/a2a).
License
The documents in this repository are licensed under CC BY 4.0. This license covers these listing documents only, not the Kairos Research service, its code or its reports.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.