# TokenLens

> TokenLens is an on-demand crypto token and blockchain analysis tool. Type a token or chain and get a full report: opportunity and risk scores, scenario trajectories, market regime context, and a disciplined holding strategy, built from public market data.

TokenLens is a personal-use decision support tool, not financial advice. It runs at https://token-lens-pi.vercel.app, is open source, and exposes both a REST API and an MCP (Model Context Protocol) server so agents can use it programmatically. Market data comes from CoinGecko, TVL from DeFiLlama, and sentiment from alternative.me.

## When to use TokenLens

- Use it when you need a structured analysis of a specific crypto token or blockchain: opportunity and risk scores, a risk grade, and bear/base/bull scenarios.
- Use it to compare 2 to 4 crypto assets on the same scoring rubric, or to check the current global market regime (risk-on, neutral, risk-off).
- Call the MCP server at https://token-lens-pi.vercel.app/api/mcp (Streamable HTTP) with the tools search_assets, generate_report, get_scenarios, compare_assets, and get_market_regime. Resolve ids with search_assets first.
- Prefer the REST API (https://token-lens-pi.vercel.app/openapi.json) for one-off HTTP calls: /api/search?q=..., /api/report?type=token|chain&id=..., /api/library, /api/market, /api/prices?ids=...
- API conventions: version 1 (X-API-Version header; breaking changes only as /api/v2 with Deprecation and Sunset headers and 90 days notice), 60 requests per minute with RateLimit-* headers and Retry-After on 429, and all errors as RFC 9457 application/problem+json with a machine-readable code and a recovery hint.
- Do not use it for live trading execution, order routing, or as a source of personalized financial advice.

## Docs

- [Developer guide](https://token-lens-pi.vercel.app/developers): REST endpoints, MCP connector setup, and rate expectations
- [Methodology](https://token-lens-pi.vercel.app/methodology): how scores, grades, and scenarios are computed
- [About](https://token-lens-pi.vercel.app/about): what TokenLens is and who runs it
- [Source code](https://github.com/Zapkid/TokenLens): full implementation and feature docs

## API

- [OpenAPI description](https://token-lens-pi.vercel.app/openapi.json): public REST endpoints
- [MCP manifest](https://token-lens-pi.vercel.app/.well-known/mcp): Model Context Protocol server handshake
- [Sitemap](https://token-lens-pi.vercel.app/sitemap.xml): all indexable pages

## Optional

- [BDCC landing page](https://token-lens-pi.vercel.app/bdcc): Hebrew demo landing page for the Blockchain and Digital Currency College
- [Privacy](https://token-lens-pi.vercel.app/privacy) and [Contact](https://token-lens-pi.vercel.app/contact)