ISHOB Knowledge Archive
License-checked research archive and technical-spec search for AI agents. Pay per call via x402.
Should I use this
Quality & Safety
Findings (5)
- HIGHTool poisoning patterns detected
- MEDIUMTool 'read_feed' description contains placeholder textin read_feed
- LOWTool 'get_fulltext' description lacks action verbin get_fulltext
- LOWTool 'weather_risk' description lacks action verbin weather_risk
- INFOTool description contains placeholder or incomplete textin read_feed
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"archive": {
"url": "https://api.ishob.com/mcp"
}
}
}Remote endpoints
https://api.ishob.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (29)
🟢search_archive(query, topic, year_from, year_to, license, ...)
Search the ISHOB archive (titles, keywords, authors). All words must match. Free.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Words to search for (all must match)"
},
"topic": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$",
"description": "Restrict to a topic slug"
},
"year_from": {
"type": "integer",
"minimum": 1800,
"maximum": 3000
},
"year_to": {
"type": "integer",
"minimum": 1800,
"maximum": 3000
},
"license": {
"type": "string",
"enum": [
"CC0",
"PDM",
"CC-BY",
"CC-BY-SA"
]
},
"fulltext": {
"type": "boolean",
"description": "Only resources with structured full text"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_topics
List knowledge topics with live resource counts. Free.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_catalog_page(page, topic)
Browse the catalog, 100 resources per page, optionally by topic. Free.
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 0,
"default": 0
},
"topic": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_document(id)
Record metadata, abstract, license and attribution for one resource. Paid ($0.001, x402).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "Resource id from search_archive / get_catalog_page, e.g. pmc-13364419"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_fulltext(id)
Structured full text (sections) of one resource, with license. Paid ($0.01, x402).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "Resource id from search_archive / get_catalog_page, e.g. pmc-13364419"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_references(id)
Parsed reference list of one resource. Paid ($0.002, x402).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 80,
"description": "Resource id from search_archive / get_catalog_page, e.g. pmc-13364419"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_webpage(url)
Fetch a public web page live (robots.txt respected) and return clean Markdown. Not stored or redistributed. Paid ($0.0005, x402).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public http(s) URL"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢site_metadata(url)
Extract a page's title, meta tags, OpenGraph, Twitter card, canonical/icons/feeds and JSON-LD from the <head> only (no full DOM download, robots.txt respected, nothing stored). Paid ($0.0002, x402).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public http(s) page URL"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_dataset(key, page, id, country_code, continent)
Static Knowledge Base: open, commercially reusable datasets (world cities, countries, ISHOB topics) by page, by id or by facet filter, with licence and attribution. Free catalogue: /v1/datasets. Paid ($0.0001, x402).
Input Schema
{
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "Dataset key from /v1/datasets, e.g. world-cities, countries, archive-topics"
},
"page": {
"type": "integer",
"description": "Page number (default 0)"
},
"id": {
"type": "string",
"description": "Return one record by id"
},
"country_code": {
"type": "string",
"description": "Facet filter (world-cities), e.g. FR"
},
"continent": {
"type": "string",
"description": "Facet filter (countries), e.g. Europe"
}
},
"required": [
"key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢weather_risk(lat, lon, hours)
Current weather and hourly forecast (MET Norway, CC BY 4.0) for a lat/lon, plus decision flags: drone_safe, event_risk (low/moderate/high), rain_expected, frost_risk, high_wind — with the thresholds used. Heuristics, not aviation or safety advice. Paid ($0.0003, x402).
Input Schema
{
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lon": {
"type": "number"
},
"hours": {
"type": "integer",
"description": "Forecast window the flags cover"
}
},
"required": [
"lat",
"lon"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢domain_intel(domain, checks)
Domain intelligence: registration via RDAP (registrar, created/expiry dates, status, nameservers, DNSSEC; unregistered = likely available), DNS (A/AAAA/NS/MX/SPF/DMARC, email and DNS providers) and the homepage tech stack (CDN, hosting, server, CMS, frameworks, analytics, payments) with evidence. Paid ($0.0004, x402).
Input Schema
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"description": "Domain or URL, e.g. example.com"
},
"checks": {
"type": "array",
"items": {
"type": "string",
"enum": [
"registration",
"dns",
"tech"
]
},
"description": "Default: all three"
}
},
"required": [
"domain"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢geocode(ip, q, postcode, country, lat, ...)
Offline geocoding (GeoNames + DB-IP, CC BY 4.0): exactly one of ip (IPv4/IPv6 -> country/region/city/lat,lon), q (place name, e.g. 'Springfield, IL, US', optional country filter), postcode (+country), or lat+lon (reverse: nearest places). City/place level; no street addresses. Paid ($0.0002, x402).
Input Schema
{
"type": "object",
"properties": {
"ip": {
"type": "string",
"description": "Public IPv4/IPv6 address"
},
"q": {
"type": "string",
"description": "Place name; qualifiers after commas (region, country)"
},
"postcode": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO alpha-2/3 or English name"
},
"lat": {
"type": "number"
},
"lon": {
"type": "number"
},
"limit": {
"type": "integer"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢extract_tables(url, pages)
Extract tables as structured JSON (rows, header, records keyed by column) from a public PDF (multi-column / ruled tables, up to 30 pages, 10 MB) or an HTML page (colspan/rowspan expanded). robots.txt respected; nothing stored. No OCR. Paid ($0.0008, x402).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Public URL of a PDF or HTML page"
},
"pages": {
"type": "string",
"description": "PDF pages, e.g. '1-3,7' (default: first 30)"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢finance_snapshot(ticker)
Fundamentals and ratios for a US-listed company from its latest annual SEC filing (10-K/20-F, public domain): revenue, net income, EPS, cash flow, debt, equity; debt-to-equity, current/quick ratio, margins, ROE/ROA, growth. P/E and market cap are null (no licensed price feed); EPS and shares outstanding are included to compute them. Paid ($0.0005, x402).
Input Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "Ticker of an SEC-registered company, e.g. AAPL, MSFT, BRK-B"
}
},
"required": [
"ticker"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢screenshot(url, width, height, full_page, format, ...)
Render a public web page in headless Chromium (Cloudflare Browser Rendering) and return a screenshot (PNG/JPEG/WebP, base64) for vision models: viewport up to 1920x1920 (default 1920x1080) or full page up to 8000 px. robots.txt respected; every page request is SSRF-guarded; nothing stored. Paid ($0.001, x402).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"full_page": {
"type": "boolean"
},
"format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
]
},
"quality": {
"type": "integer",
"description": "jpeg/webp only (default 80)"
},
"wait_until": {
"type": "string",
"enum": [
"load",
"domcontentloaded",
"networkidle0",
"networkidle2"
]
},
"delay_ms": {
"type": "integer"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢ping_status(url, method, check_ssl, follow_redirects)
Uptime / API health check: is a URL up, HTTP status, response time, redirect chain, headers and security headers (edge), plus the TLS certificate (issuer, expiry date, days remaining, SAN, verification errors). A down target is a valid answer. Paid ($0.0002, x402).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"method": {
"type": "string",
"enum": [
"HEAD",
"GET"
]
},
"check_ssl": {
"type": "boolean"
},
"follow_redirects": {
"type": "boolean"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢read_feed(url, limit)
Read a published RSS 2.0 / RSS 1.0 / Atom / JSON Feed (blogs, news, podcasts, Reddit, Mastodon, YouTube channel feeds) as clean JSON items: title, link, ISO dates, author, plain-text summary/content, categories, enclosures. An HTML page URL is followed to its advertised feed. robots.txt respected; nothing stored; social networks are not scraped. Paid ($0.0003, x402).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "Feed URL, or a page that advertises a feed"
},
"limit": {
"type": "integer"
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢embed_text(input, model)
Text embeddings for RAG / semantic search: one string or up to 100 strings -> L2-normalised vectors with open BAAI models on Cloudflare GPUs: bge-small-en-v1.5 (384-d, English, default) or bge-m3 (1024-d, multilingual). Up to 24,000 characters per call. Paid ($0.0002, x402).
Input Schema
{
"type": "object",
"properties": {
"input": {
"type": "array",
"items": {
"type": "string"
},
"description": "Text or list of texts (a single string is also accepted)"
},
"model": {
"type": "string",
"enum": [
"bge-small-en-v1.5",
"bge-m3"
]
}
},
"required": [
"input"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢site_speed(url, device)
Page speed & Core Web Vitals from a real headless-Chromium load (mobile or desktop): LCP, CLS, FCP, TTFB, total blocking time with good/needs-improvement/poor ratings, load timings, request count and page weight by resource type. Unthrottled lab run from Cloudflare's network (not Lighthouse, not field data). robots.txt respected. Paid ($0.0008, x402).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"device": {
"type": "string",
"enum": [
"mobile",
"desktop"
]
}
},
"required": [
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢render_document(markdown, format, css, title, page_size, ...)
Render Markdown (tables, code, lists, headings) into a styled PDF (custom CSS, A4/Letter/Legal, page numbers), a Word DOCX or standalone HTML; returns a private download link valid for 24 hours. External resources are never fetched (inline data: images only). Paid ($0.001, x402).
Input Schema
{
"type": "object",
"properties": {
"markdown": {
"type": "string"
},
"format": {
"type": "string",
"enum": [
"pdf",
"docx",
"html"
]
},
"css": {
"type": "string",
"description": "Extra CSS (pdf/html)"
},
"title": {
"type": "string"
},
"page_size": {
"type": "string",
"enum": [
"A4",
"Letter",
"Legal"
]
},
"filename": {
"type": "string"
}
},
"required": [
"markdown"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢contract_abi(chain, address, include_source, resolve_proxy)
Verified smart-contract ABI (+ optional Solidity/Vyper source) for Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Chain from the open Sourcify registry: compiler, deployment, read/write function and event signatures, and proxy resolution to the implementation ABI. Unverified contracts return 404 (not charged). Paid ($0.0004, x402).
Input Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"enum": [
"ethereum",
"base",
"arbitrum",
"optimism",
"polygon",
"bsc"
],
"description": "EVM chain"
},
"address": {
"type": "string",
"description": "Contract address"
},
"include_source": {
"type": "boolean",
"description": "Include verified source files (up to 600k characters)"
},
"resolve_proxy": {
"type": "boolean",
"description": "Also return the implementation ABI of a proxy"
}
},
"required": [
"chain",
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢token_audit(chain, address)
Token safety & scam check for an ERC-20 (Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain) or SPL mint (Solana): honeypot simulation, buy/sell tax, mint / blacklist / pause / owner privileges, LP lock, holder concentration (Powered by GoPlus Security) plus our own on-chain checks (proxy slots, owner, verified source, mint/freeze authority, Token-2022 extensions). Returns severity-ranked flags and a risk level. Paid ($0.001, x402).
Input Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"enum": [
"ethereum",
"base",
"arbitrum",
"optimism",
"polygon",
"bsc",
"solana"
]
},
"address": {
"type": "string",
"description": "Token contract (0x...) or Solana mint (base58)"
}
},
"required": [
"chain",
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢swap_route(chain, token_in, token_out, amount, amount_raw, ...)
Best DEX swap route and quote on Ethereum, Base, Arbitrum, Optimism, Polygon or BNB Chain via the KyberSwap aggregator (400+ liquidity sources, split routes): output amount, slippage-protected minimum, USD value change, gas, hops. With `sender`, also an unsigned ready-to-sign transaction plus the ERC-20 allowance check. Quotes only; ISHOB never sends transactions. Paid ($0.0008, x402).
Input Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"enum": [
"ethereum",
"base",
"arbitrum",
"optimism",
"polygon",
"bsc"
]
},
"token_in": {
"type": "string",
"description": "Token address, or 'native' for ETH/POL/BNB"
},
"token_out": {
"type": "string",
"description": "Token address, or 'native'"
},
"amount": {
"type": "string",
"description": "Amount of token_in in normal units, e.g. '1.5' (or use amount_raw)"
},
"amount_raw": {
"type": "string",
"description": "Amount of token_in in base units (wei)"
},
"slippage_bps": {
"type": "integer",
"description": "Slippage tolerance in basis points"
},
"sender": {
"type": "string",
"description": "Optional wallet address: returns an unsigned transaction + allowance check"
}
},
"required": [
"chain",
"token_in",
"token_out"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢crypto_prices(tokens, yields_chain, change_24h)
Live token prices computed from on-chain DEX pools (Uniswap V3, PancakeSwap V3, Orca Whirlpools) on Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain and Solana, with pool depth, confidence and 24h change; plus an Aave V3 yield screener (supply/borrow APY and market size per asset). No third-party price feed: every figure is derived from public chain state. Paid ($0.0002, x402).
Input Schema
{
"type": "object",
"properties": {
"tokens": {
"type": "string",
"description": "Comma-separated, max 10: symbols (ETH, BTC, SOL, BNB, POL, ARB, OP, USDC, USDT, DAI, LINK, UNI, AAVE) or chain:address (base:0x..., solana:<mint>)"
},
"yields_chain": {
"type": "string",
"enum": [
"ethereum",
"base",
"arbitrum",
"optimism",
"polygon",
"bsc"
],
"description": "Also return Aave V3 supply/borrow APY for every market on this chain"
},
"change_24h": {
"type": "boolean",
"description": "Include 24h price change (EVM)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢gas_tracker(chains, usd)
Real-time gas fees and network health for Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain and Solana: slow / standard / fast EIP-1559 fees (base fee + priority tip, from the last 20 blocks), cost of a transfer / ERC-20 transfer / swap in native token and USD, congestion, base-fee trend, block time and latest-block age; Solana priority-fee percentiles and TPS. Paid ($0.0001, x402).
Input Schema
{
"type": "object",
"properties": {
"chains": {
"type": "string",
"description": "Comma-separated subset of: ethereum, base, arbitrum, optimism, polygon, bsc, solana (default: all)"
},
"usd": {
"type": "boolean",
"description": "Include USD cost estimates"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢wallet_portfolio(address, chains, tokens, min_usd)
Multi-chain wallet portfolio: native balances and token holdings with USD values and totals per chain. EVM addresses are checked on Ethereum, Base, Arbitrum, Optimism, Polygon and BNB Chain (native + ~75 major tokens + up to 20 tokens you pass); Solana addresses list SOL and every SPL / Token-2022 holding. Prices come from on-chain DEX pools. Read-only public data. Paid ($0.0005, x402).
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "EVM 0x address or Solana base58 address"
},
"chains": {
"type": "string",
"description": "EVM only: comma-separated subset of ethereum, base, arbitrum, optimism, polygon, bsc (default all)"
},
"tokens": {
"type": "string",
"description": "EVM only: up to 20 extra tokens as chain:0x... (comma-separated)"
},
"min_usd": {
"type": "number",
"description": "Hide priced holdings worth less than this"
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢simulate_tx(chain, from, to, data, value, ...)
Simulate a transaction before signing it: what leaves and enters the wallet (native, ERC-20, NFTs, SPL) with USD values, approvals granted (unlimited / to non-contracts), revert reason, gas and fee, plus a risk level. EVM chains via eth_simulateV1 (raw call: from, to, data, value); Solana via simulateTransaction (base64 transaction, unsigned is fine). Nothing is broadcast. Paid ($0.0015, x402).
Input Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"enum": [
"ethereum",
"base",
"arbitrum",
"optimism",
"polygon",
"bsc",
"solana"
]
},
"from": {
"type": "string",
"description": "EVM: sender address"
},
"to": {
"type": "string",
"description": "EVM: target address"
},
"data": {
"type": "string",
"description": "EVM: calldata hex (default 0x)"
},
"value": {
"type": "string",
"description": "EVM: value in wei (decimal or 0x hex)"
},
"gas": {
"type": "string",
"description": "EVM: optional gas limit"
},
"transaction": {
"type": "string",
"description": "Solana: base64-encoded transaction (legacy or v0; signatures not required)"
}
},
"required": [
"chain"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_specs(query, category, topic, year_from, limit)
Full-text search over abstracts and full texts, with extracted technical specifications (values, ranges, tolerances, units). Numeric constraints like "50 Nm" are matched. Paid ($0.001, x402).
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Words and optional numeric constraints, e.g. 'torque sensor 50 Nm'"
},
"category": {
"type": "string",
"enum": [
"general",
"tech_specs"
],
"default": "tech_specs"
},
"topic": {
"type": "string",
"pattern": "^[a-z0-9-]{1,64}$"
},
"year_from": {
"type": "integer",
"minimum": 1800,
"maximum": 3000
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 10
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢query_specs(query, quantity, family, unit, min, ...)
Structured specification table filtered by quantity (e.g. accuracy, wavelength, range), unit family, unit and value range, with source document and license. Paid ($0.001, x402).
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 200,
"description": "Optional words the source document must contain"
},
"quantity": {
"type": "string",
"maxLength": 40,
"description": "e.g. accuracy, resolution, range, wavelength, torque, temperature"
},
"family": {
"type": "string",
"maxLength": 40,
"description": "Unit family: length, pressure, torque, force, temperature, frequency, power, voltage, current, mass, volume, time, percent"
},
"unit": {
"type": "string",
"maxLength": 12,
"description": "Exact unit, e.g. nm, MPa, N·m"
},
"min": {
"type": "number"
},
"max": {
"type": "number"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 50
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence