Gives MCP agents 575+ pay-per-call tools for data, AI, storage, queues, and event watchers, settled in USDC via x402.
Also known as 2s-io/sdk, @2sio/mcp
- Stars
- 9
- Tools
- 300
- Downloads, 30 days
- 1,648
- Latest version
- 1.82.0
- Last commit
- Oct 24, 2026
- License
- MIT
What is 2s.io MCP?
2s.io gives MCP agents 575+ pay-per-call tools for data, AI, storage, queues, and event watchers, settled in USDC via x402. It exposes 300 tools, such as search.endpoints, batch.run, soil.profile.
Summary generated from the project's README
About 2s.io MCP server
Providing AI agents with a massive library of specialized data and infrastructure tools is what this server enables. It exposes over 575 pay-per-call tools through the Model Context Protocol, covering diverse domains such as legal case searches, SEC filings, patent lookups, medical ICD-10 codes, and geospatial weather data. Developers can integrate these capabilities into hosts like Claude Desktop, Cline, or AgentKit by running the server locally via npx or connecting to a hosted URL.
Transactions are settled in USDC via the x402 protocol on Base or Solana, allowing for usage-based billing where users pay for actual consumption. The server includes agent primitives like distributed locks, message queues, and wallet-keyed storage, alongside a unique watcher system that pushes signed callbacks for specific events like stock price changes or wallet activity. Users can manage costs by setting a maxPriceUsd limit to prevent unexpected spending during tool execution.
What you can do with it
- 1Real-time event monitoringSet up a watcher so the agent is notified immediately when a specific stock price is hit.
- 2Managing agent state and coordinationUse distributed locks and durable queues to coordinate complex multi-agent workflows.
- 3Extracting structured web dataConvert a raw URL into clean markdown or extract specific schemas from a webpage.
Written from the project's README. Every use case is checked against a quote from it.
How to install 2s.io MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall 2s.io MCP in Claude Code
$ claude mcp add --env 'EVM_PRIVATE_KEY=<YOUR_EVM_PRIVATE_KEY>' mcp -- npx -y @2sio/mcpInstall 2s.io MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@2sio/mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<YOUR_EVM_PRIVATE_KEY>"
}
}
}
}Install 2s.io MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@2sio/mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<YOUR_EVM_PRIVATE_KEY>"
}
}
}
}Install 2s.io MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@2sio/mcp"],"env":{"EVM_PRIVATE_KEY":"<YOUR_EVM_PRIVATE_KEY>"}}'Install 2s.io MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@2sio/mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<YOUR_EVM_PRIVATE_KEY>"
}
}
}
}Install 2s.io MCP in Codex
$ codex mcp add mcp --env 'EVM_PRIVATE_KEY=<YOUR_EVM_PRIVATE_KEY>' -- npx -y @2sio/mcpInstall 2s.io MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@2sio/mcp"] [mcp_servers.mcp.env] EVM_PRIVATE_KEY = "<YOUR_EVM_PRIVATE_KEY>"
Install 2s.io MCP in Gemini CLI
$ gemini mcp add -s user -e 'EVM_PRIVATE_KEY=<YOUR_EVM_PRIVATE_KEY>' mcp npx -- -y @2sio/mcpInstall 2s.io MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@2sio/mcp"
],
"env": {
"EVM_PRIVATE_KEY": "<YOUR_EVM_PRIVATE_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @2sio/mcp 1.82.0 in an isolated container with no network and no keys. It answered and listed 300 tools.
2s.io MCP tools 300
Read from the server with tools/listsearch.endpointsFind the right 2s endpoint(s) for a task using a natural-language query (e.g. "screen a company for sanctions", "decode a VIN", "check a domain's email security"). Returns ranked matches with id, path, method, price, and description. Use this to discover capabilities before calling.
batch.runRun up to 50 endpoint calls behind ONE x402 payment. Price = exact sum of the sub-call prices (no discount). Atomic: every sub-call must succeed or nothing is charged (failures are returned so you can retry for free). Sub-calls must be ordinary catalog endpoints (no bearer-only, deprecated, variable-priced, or metered-upstream endpoints; no nested batch). Each item carries that endpoint's own response in `data`.
soil.profileGround-truth soil profile for any US lat/lng from USDA-NRCS SSURGO. Returns the soil map unit + component soil types ranked by composition %, each with taxonomic order/class, drainage class, hydrologic group, and slope. Keyless, public-domain. For agronomy, land/septic/foundation suitability, hydrology, crop-fit. Water/unsurveyed points return an empty component list.
soil.hardiness-zoneUSDA Plant Hardiness Zone for a US ZIP code — planting zone (e.g. "9b") + average annual minimum-temperature range (°F) + ZIP centroid. Keyless, public-domain. The "what grows where" primitive for gardening/landscaping/nursery/agronomy.
agriculture.droughtUS Drought Monitor severity for a county (5-digit FIPS) or state (2-letter). Weekly % of area in each category (None, D0 Abnormally Dry → D4 Exceptional), newest first, with the worst category per week. Keyless, public-domain (NDMC/USDA/NOAA). The official metric behind USDA disaster eligibility.
agriculture.statsUSDA NASS QuickStats — authoritative US ag statistics: crop yields, acreage, production, livestock inventory, prices received. Filter by commodity (CORN/SOYBEANS/CATTLE…), year (or year__GE/__LE range), state (2-letter), county, statistic category (YIELD/PRODUCTION/AREA HARVESTED/PRICE RECEIVED), aggregation level. 50k-row cap — narrow broad queries. Public-domain.
telecom.fcc-filingsSearch FCC ECFS filings for a proceeding/docket (e.g. 17-108 net neutrality, 11-42 Lifeline), optionally by filer. Returns newest filings with submission id, filer, type, lead bureau, received/disseminated dates, doc count. Track FCC regulatory dockets, comments, ex-parte filings. Public-domain.
telecom.market-areaMap a US lat/lon to its FCC spectrum-licensing geographies — Cellular Market Area (CMA), Basic/Major Trading Area (BTA/MTA), Partial Economic Area (PEA), and BEA/EAG/MEA/REAG economic areas — plus 2020 Census block FIPS, county, and block population. These define spectrum-license boundaries; distinct from ordinary geocoding. Keyless, public-domain.
occupation.profileFull occupation dossier from O*NET (US DOL) by SOC/O*NET-SOC code (e.g. 15-1252). Returns title, description, bright-outlook flag, sample job titles, and top skills, knowledge, abilities, work tasks, and technology tools. CC-BY. The canonical occupation reference for résumé/JD reasoning + career mapping; pair the code with labor.wages.
occupation.searchFind O*NET occupations by keyword (job title, skill, or activity). Returns ranked occupations with SOC/O*NET-SOC code + title. The "occupation code for this job/skill" primitive — every occupation.* / labor.wages call composes on the code. CC-BY.
occupation.relatedOccupations related/career-adjacent to a given O*NET occupation, by SOC/O*NET-SOC code. Returns ranked related occupations (code + title). For career-pathing and transferable-skills reasoning. CC-BY.
labor.wagesOccupational employment + wages from BLS OEWS by SOC code, nationally or by US state. Pass soc (e.g. 15-1252 Software Developers) + optional 2-letter state. Returns employment, hourly mean, and annual mean + 10th/25th/median/75th/90th-percentile wages (latest survey year). Authoritative ground-truth wages for comp benchmarking. Public-domain.
Show all 300 toolsShow fewer tools
labor.openingsUS labor-market turnover from BLS JOLTS (total nonfarm, national), monthly newest-first. measure = openings (default) / hires / quits / layoffs / separations. Returns level in thousands per month. The standard labor-tightness (openings) + worker-confidence (quits) signal. Public-domain.
labor.unemploymentUS unemployment from BLS, monthly newest-first — national (CPS, area="US") or by state (LAUS). measure = rate (default) / unemployed / employed / laborforce. Seasonally adjusted; rate in percent, counts in thousands. Public-domain.
maritime.vesselSearch the US Coast Guard PSIX vessel registry by name (partial), call sign, official number, hull number (HIN), flag, service type, or build year. Returns vessels with USCG vessel id, name, call sign, service type, build year, status, official number, HIN, flag. Keyless, public-domain. US-flagged vessels + foreign vessels with US PSC activity. Pair vesselId with maritime.cases.
maritime.casesUS Coast Guard activity / port-state-control case history for a vessel, by USCG vessel id (from maritime.vessel). Returns cases newest-first with activity id, start date, type (Boarding, Inspection, Investigation…), and process status. Keyless, public-domain. The compliance/inspection record behind a vessel.
maritime.portLook up world ports and terminals in the NGA World Port Index (Pub 150, ~2,950 ports) by port name (partial) and/or country (full name, e.g. "Japan"). Returns matching ports with location (lat/lon, country, region), UN/LOCODE, harbor size/type and shelter, max vessel length/draft (m), channel/anchorage/cargo-pier depths, tidal range, and chart number. Keyless, public-domain (NGA). Physical-port reference an LLM cannot recall; complements maritime.vessel + maritime.cases.
music.recordingResolve a song/recording from MusicBrainz (open, CC0 music encyclopedia). Pass artist + title, or a free-text/Lucene query. Returns ranked recordings with MBID, title, primary artist, length (ms), first-release date, disambiguation. Keyless, public-domain. Canonicalize a track to its MBID.
music.artistResolve a music artist from MusicBrainz (CC0). Pass a name or query. Returns ranked artists with MBID, name, sort name, type (Person/Group), country, gender, life span, disambiguation. Keyless, public-domain.
music.releaseResolve an album/release from MusicBrainz (CC0). Pass a barcode (UPC/EAN), artist + album, or a free-text query. Returns ranked releases with MBID, title, artist, date, country, barcode, status, track count, label, catalog number. Barcode → album is the differentiated lookup. Keyless, public-domain.
patents.searchSearch US patent applications and grants (USPTO Open Data Portal). Returns titles, inventors, applicants, status, classification codes, and Patent Center URLs.
patents.detailFull file-wrapper detail for a US patent application: bibliography, event timeline (filings, Office Actions, allowances), continuity chain (parents, divisionals), assignments, foreign priority.
patents.documentsList every document in a US patent application file wrapper: Office Actions (CTNF, CTFR), IDS, claims, notices of allowance. Returns code, description, official date, and Patent Center download URL.
crypto.address-validateValidate a cryptocurrency address with full checksum verification (not just regex). Catches typos before sending funds. Chains: btc, eth, sol, ltc, trx, xrp, bch.
crypto.txLive EVM transaction status + receipt by hash: mined/reverted/pending, block, confirmations, timestamp, from/to, value, gas used, effective gas price, total fee, contract created, log count. Chains: base, ethereum, polygon, arbitrum, optimism. Confirm a payment settled or a tx reverted before acting. 404 if unknown.
validate.ibanValidate an IBAN (International Bank Account Number) with full ISO 13616 checks: country-specific length + ISO 7064 mod-97 checksum, not just regex. Returns valid flag, normalized + 4-char-grouped form, country, check digits, and BBAN. Deterministic, ~85 countries — validate AND canonicalize bank details in one call instead of doing checksum math in an LLM.
validate.gtinValidate a product barcode (GTIN-8/12/13/14, UPC-A, EAN-13, ISBN-10/13) with the GS1 mod-10 / ISBN mod-11 check digit. Returns valid, type, and the canonical GTIN-14 key for product-master dedup. Deterministic — no checksum math in the LLM.
validate.abaValidate a US bank ABA routing number with the Federal Reserve weighted mod-10 (3-7-1) checksum, not just a regex. Returns valid, routingNumber, and routing-symbol district. Catches transposed digits in ACH/wire setup.
validate.leiValidate a Legal Entity Identifier (LEI, ISO 17442) with the ISO 7064 mod-97-10 check digits. Returns valid, normalized LEI, and the issuing LOU prefix. Confirms a counterparty/vendor LEI is well-formed before GLEIF lookup.
validate.bicValidate a SWIFT/BIC code (ISO 9362): 8 or 11 chars = institution + ISO country + location + optional branch, with the country checked against ISO 3166. Returns parsed parts. Structure only, not a directory lookup.
validate.glnValidate a GS1 GLN (Global Location Number), 13 digits with the GS1 mod-10 check digit. GLNs identify trading parties + physical locations in CPG supply chains / EDI. Deterministic.
validate.ssccValidate a GS1 SSCC (Serial Shipping Container Code), 18 digits with the GS1 mod-10 check digit. SSCCs identify logistic units (pallets/cases) — the key field in shipping/ASN (EDI 856). Deterministic.
validate.isinValidate an ISIN (ISO 6166 securities identifier): 2-letter country + 9-char NSIN + Luhn check digit. Returns valid, country, nsin, and the embedded CUSIP for US/CA issues. Catches transposed chars in security master data.
validate.cusipValidate a CUSIP (9-character US/Canada securities identifier) with its mod-10 weighted check digit. Returns valid + check digit. Deterministic security-master validation.
validate.batchValidate up to 100 mixed identifiers in one deterministic call. Pass items=[{type,value}] with type one of iban, gtin, aba, lei, bic, gln, sscc, isin, cusip. Each result (in input order, with index + type) carries valid/reason plus the same type-specific fields the single endpoints return. One bad value or unsupported type degrades to that item only. Collapses a whole record of checksum checks into one round-trip.
convert.unitDeterministic unit-of-measure conversion: mass (g/kg/lb/oz/t…), length (m/km/in/ft/mi…), volume (l/ml/gal/qt/cup…), area (m2/ft2/acre/ha), temperature (C/F/K). Case-insensitive with aliases (kg/kilogram). Returns the exact result + dimension. Cross-dimension (kg→m) is rejected. Ground-truth factors instead of an LLM approximation.
convert.currencyConvert an amount between currencies at a live or historical exchange rate. Pass from + to (3-letter ISO 4217) + optional amount (default 1) + date (YYYY-MM-DD for historical; omit for latest). Returns the converted result, per-unit rate, and effective rate date. Live ECB reference rates (via Frankfurter), fetched per request — never stale; weekends/holidays use the last business day. ECB major currencies.
iso.currencyISO 4217 currency lookup. Pass code (alphabetic USD or 3-digit numeric 840) or country. Returns alphabetic + numeric code, English name, minor unit (decimal places — JPY 0, USD 2, BHD 3), and countries using it. Bundled authoritative ISO 4217 data.
iso.languageISO 639 language lookup. Pass code in any form — 639-1 (en), 639-2/B (ger), 639-2/T (deu) — or name. Returns the English name + all sibling codes (alpha-2, alpha3-B, alpha3-T), resolving the bibliographic/terminological split (German = de/deu/ger). Bundled authoritative ISO 639 data.
iso.subdivisionISO 3166-2 subdivision lookup (states/provinces/regions). Pass code (US-CA) to resolve one → name + country, or country (2-letter, US) to list all its subdivisions with codes. Bundled authoritative ISO 3166-2 data (~3.8k subdivisions, 237 countries).
calendar.holidaysList the official holidays for a country and year with exact observed dates, including substitute days (e.g. a Saturday July 4th observed Friday). 200+ countries, regional subdivisions (US states, German Länder, Canadian provinces…), movable feasts and lunar-calendar holidays computed from maintained rules. Filter by type (public, bank, school, optional, observance) and localize names via lang. Returns {date, name, type, substitute, rule} per holiday.
calendar.business-daysHoliday-aware business-day calculator for 200+ countries — the ground-truth answer for payment terms, SLA deadlines, and delivery dates instead of guessing holidays. Three modes: start+addDays shifts a date by N business days (signed); start+end counts business days between two dates (exclusive of start, inclusive of end); start alone checks one date (business day? which holiday? next/previous business day). Custom weekends supported (e.g. fri,sat for the Gulf). Skipped holidays are itemized.
tax.vatValidate an EU VAT number against the official VIES register in real time. Confirms current registration for intra-EU trade and, when the member state discloses it, returns the registered business name + address. Covers the 27 EU states (Greece as EL) plus Northern Ireland (XI); Great Britain (GB) is not in VIES. Pass vat (full identifier like DE811569869) OR country + number. Returns {valid, countryCode, vatNumber, name, address, requestDate, reason}.
tax.vat-ratesCurrent EU VAT rates by member state — standard rate plus reduced/super-reduced/parking/zero rates — from the European Commission TEDB, refreshed regularly. Pass country (ISO 2-letter; Greece is EL) for one state, or omit for all 27. Each result returns standardRate, reducedRates[], every rate category with its percentage, and the date in force. Pairs with tax.vat (number validation).
inflation.calculatorAdjust a US dollar amount for inflation between two dates ('what is $100 in 1990 worth today?') using CPI-U. Returns the adjusted amount, cumulative inflation %, annualized rate, and the CPI values used. Source: BLS CPI via FRED.
inflation.ratesCurrent US inflation by measure with index level + YoY/MoM %. Pass measure (cpi, core-cpi, pce, core-pce, ppi, cpi-shelter, cpi-energy, import-prices, ...) or omit for all. The YoY change is the headline inflation rate. Source: BLS/BEA via FRED.
inflation.expectationsUS inflation expectations — 5y & 10y TIPS breakevens, 5y5y forward, and U-Michigan 1-year consumer expectation. Each a percent. Market breakevens update daily. Source: Fed/Treasury via FRED.
inflation.hicpEU harmonized inflation (HICP annual rate) — the official cross-country-comparable inflation rate for the EU, euro area, and each member state. Pass country (Eurostat geo: DE, FR, EL=Greece, EA20=euro area, EU27_2020=EU) or omit for all. Source: Eurostat (keyless). For US inflation use inflation.rates.
econ.indicatorLatest reading of a curated US macro indicator (+ prior, year-ago, YoY %). Pass indicator (unemployment-rate, fed-funds-rate, real-gdp, gdp-growth, nonfarm-payrolls, 10y-treasury, 30y-mortgage, consumer-sentiment, ...) or omit for all. Source: BLS/BEA/Fed via FRED.
econ.fredAny series in the Federal Reserve's FRED database (800k+ economic time series). Pass seriesId (e.g. UNRATE, CPIAUCSL, GDP, DGS10, MORTGAGE30US) for metadata + recent observations (optionally bounded by start/end), or query to full-text search the catalog. Free, public-domain for most series (FRED attribution). Distinct from econ.indicator (curated headline set) — this is the full FRED catalog by id or search.
econ.fred-releasesUS economic-data release CALENDAR from FRED — when official reports are published. Returns upcoming release dates (date, release name, release id) from `from` (default today), ascending. Filter by name (e.g. "Consumer Price Index" for next CPI, "Employment Situation" for jobs) or releaseId. Free, public-domain. Future release dates an LLM cannot know — for trading/scheduling/macro agents. Pair with econ.fred for the numbers.
econ.fred-vintagePoint-in-time (vintage) economic data from FRED's ALFRED archive — what a figure was AS FIRST REPORTED / as known on a past date, before revisions. Give seriesId (GDP, GDPC1, PAYEMS…) + asOf date for the values as they stood then (omit asOf for current); also returns the series' revision dates. Free, public-domain. Eliminates look-ahead bias for backtesting/macro research — unavailable from any LLM or real-time API.
econ.fred-categoriesBrowse the FRED category tree to DISCOVER economic series. Pass categoryId for that category (name+parent) + its child categories + its most-popular series (id/title/units/frequency); omit (or 0) for the 8 top-level categories. Walk down via child ids, then fetch with econ.fred. Free, public-domain.
econ.fred-regionalFRED regional economic data — one snapshot of a regional FRED series across ALL its geographies (every U.S. state, county, or metro) for a single period. Pass a regional series id (e.g. WIPCPI = per-capita personal income by state) and get each region's name, FIPS region code, value, and per-region series id, plus units/frequency/available date range. Add date (YYYY-MM-DD) for a point-in-time cross-section; omit for latest. Authoritative St. Louis Fed (GeoFRED) data agents can't recite. Free, public-domain.
econ.yield-curveCurrent US Treasury yield curve (1M–30Y constant-maturity yields) plus the 2s10s and 3m10y spreads and an inversion flag (recession signal). Daily data. Source: US Treasury via FRED.
econ.commodityLatest benchmark commodity price + % change. Pass commodity (wti, brent, natural-gas, gasoline, diesel, heating-oil, propane, copper, aluminum, corn, wheat, sugar) or omit for all. Each names the FRED series + unit. Source: EIA/IMF via FRED.
econ.recessionComposite US recession-signal dashboard: NY Fed recession probability (12mo ahead), Sahm-rule real-time indicator (≥0.50 = recession begun), and 10y2y Treasury spread (negative = inverted). Each with value, date, triggered flag, and a count of signals flashing. A read of the standard gauges, not a forecast. Source: FRED.
edi.parseParse a raw ANSI X12 EDI document (B2B purchase orders, invoices, ship notices, etc.) into clean structured JSON. POST edi with the raw interchange text. Auto-detects delimiters; returns interchange metadata, each functional group + transaction set with its type decoded (850 PO, 810 invoice, 856 ASN, 855 PO ack, 997 ack), every segment named, and a semantic summary (PO/invoice numbers, parties, line items, totals). Deterministic, no external calls.
edi.edifactParse a raw UN/EDIFACT document (the B2B EDI standard used across Europe, Asia, logistics and customs — international counterpart to ANSI X12) into clean structured JSON. POST edi with the raw interchange text. Reads the optional UNA service-string advice to auto-detect delimiters (or applies UN defaults); handles release-character escaping; returns the interchange envelope (UNB: sender/recipient with qualifiers, date/time, control reference, test indicator) and each message with its type decoded (ORDERS PO, INVOIC invoice, DESADV ASN, ORDRSP PO response, CONTRL ack), every segment named (BGM, DTM, NAD, LIN, QTY, MOA…), and a semantic summary (order/invoice numbers, dates, parties with role decoded, line items, totals). Deterministic, no external calls.
edi.edifact-generateGenerate an outbound UN/EDIFACT document from JSON (international counterpart to edi.generate/X12). POST type ('ORDERS' PO or 'INVOIC' invoice) + senderId, recipientId, documentNumber, optional date, parties (NAD role+name), items (quantity, productId, price), and for INVOIC optional total. Returns the full EDIFACT interchange in meta.edi (UNA/UNB/UNH…UNT/UNZ with BGM/DTM/NAD/LIN/QTY/PRI/MOA), proper delimiters + release-char escaping. Deterministic; round-trips through edi.edifact.
domain.email-securityGrade a domain's email-authentication / DNS-security posture from live DNS in one call: SPF, DMARC (policy), DKIM (supplied/common selectors), MTA-STS, TLS-RPT, DNSSEC, CAA, BIMI. Pass domain (+ optional dkimSelector). Returns a letter grade, a summary (incl. spoofingProtected), and a per-mechanism block with the raw record, parsed tags, and specific issues. Live DNS via DoH (keyless) — an LLM can't know a domain's current records.
domain.ct-logsCertificate Transparency recon for a domain — discover its subdomains and issued certificates from public CT logs (passive attack-surface mapping). Pass domain (+ optional limit). Returns deduplicated subdomains + certs (issuer, validity, SAN names), newest first. certSpotter primary, crt.sh fallback, keyless. CT shows names that ever appeared in a cert, not necessarily live hosts.
security.http-headersFetch a URL and grade its HTTP security headers (CSP, HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, COOP/CORP). Pass url. Returns a letter grade + score, present/missing headers, and a per-header analysis with the live value and issues. Also flags Server/X-Powered-By info disclosure. SSRF-guarded live fetch (private targets refused) — an LLM can't see a site's current headers.
security.password-exposureCheck whether a password appears in known breaches via Have I Been Pwned's k-anonymity model — only the first 5 chars of the password's SHA-1 are sent upstream, never the password or full hash. POST { password } (hashed server-side) or { sha1 } (the 40-hex SHA-1, for zero-knowledge). Returns breached + count. 900M+ breach corpus; for signup/password-policy enforcement. Absence ≠ strength.
security.ioc-reputationThreat-intel reputation for an IOC — pass ioc as an IP, domain, URL, or file hash (auto-detected). Returns a malicious boolean + per-source breakdown: abuse.ch ThreatFox, URLhaus, MalwareBazaar, Feodo Tracker (botnet C2 IPs), Tor exit nodes, Spamhaus DROP. Live, hourly-rotating threat feeds an LLM cannot know — a ground-truth check for SOC alert triage. Absence ≠ safety.
security.ip-reputationMulti-source IP reputation with one combined authority score (0-100). Polls AbuseIPDB (crowd abuse confidence), abuse.ch threat-lists (Feodo C2 + ThreatFox + Spamhaus DROP + Tor), blocklist.de (fail2ban network), and StopForumSpam in parallel and blends them into a verdict (clean/low/suspicious/malicious) + flaggedBy + per-source opinions + enrichment (ISP, usage type, country, ASN, Tor). Authoritative threat-list hits hard-floor the verdict at malicious. The one-call 'should I trust this IP?'.
security.ip-abuseAbuseIPDB single-IP abuse check. Pass ip (IPv4/IPv6). Returns abuseConfidenceScore (0-100), totalReports, numDistinctUsers, lastReportedAt, usageType, ISP, domain, hostnames, isTor, isWhitelisted, country. verbose=true adds individual report records; maxAgeInDays (1-365, default 90) bounds the window. Live crowd data for SOC triage and login-abuse blocking.
security.ip-blacklistAbuseIPDB bulk blacklist — most-reported abusive IPs above a confidence threshold (the fail2ban / firewall block-feed). Tune confidenceMinimum (25-100, default 90), limit (1-10000), ipVersion (4/6), onlyCountries / exceptCountries (ISO-2). Returns each IP with country, confidence, lastReportedAt + the list generatedAt.
security.ip-blockAbuseIPDB subnet (CIDR) check — which IPs inside a network block have been reported. Pass network as a CIDR (e.g. 118.25.0.0/24; up to /16 IPv4, /112 IPv6). Returns block metadata + reportedAddress (each flagged IP with numReports, confidence, mostRecentReport, country). Optional maxAgeInDays (default 30), limit. Vet a hosting range or sweep your own allocation.
security.cweAuthoritative MITRE CWE (Common Weakness Enumeration) lookup. Pass id (CWE-79 or 79) for the canonical weakness — name, abstraction, description, ChildOf/ParentOf relationships, mapped CAPEC patterns (all with names) — or query for keyword search. Bundled (~970), zero external calls. Anti-hallucination: agents cite CWE IDs/names that must be exact. Pairs with security.cve + security.capec.
security.attackAuthoritative MITRE ATT&CK (Enterprise) technique lookup. Pass id (T1059 / T1059.001) for name, tactics, description, platforms, sub-technique parent, mitigations, detection — or query for keyword search. Bundled (~700 techniques), zero external calls. Agents cite T-numbers + tactics that must be exact. For threat modeling, detection engineering, report enrichment.
security.capecAuthoritative MITRE CAPEC (Common Attack Pattern Enumeration) lookup. Pass id (CAPEC-66 or 66) for name, abstraction, description, likelihood, severity, mapped CWE weaknesses + related patterns (with names) — or query for keyword search. Bundled (~615), zero external calls. The attacker view; CAPEC↔CWE cross-links let an agent pivot between an attack and the weakness it exploits.
security.exploit-availabilityDoes public exploit code exist for a CVE, and where? Pass cve (CVE-2021-44228). Returns hasPublicExploit, count, hasMetasploitModule + hasVerifiedExploit flags, and Exploit-DB entries (description, type, platform, date, link). Bundled Exploit-DB index (~25k CVEs). The 'is it weaponized?' triage signal BEYOND security.cve's KEV (in-the-wild) + EPSS (probability). Absence != no exploit exists.
net.rpki-validityRPKI Route Origin Validation for a (BGP origin AS, prefix) pair — is this AS authorized to originate this prefix? Pass asn (AS15169) + prefix (8.8.8.0/24). Returns status (valid / invalid = possible hijack / unknown), a hijackSignal boolean, validating ROAs, and a description. Live RIR/RPKI data via RIPEstat (keyless). The core BGP-security check.
vehicle.fuel-economyOfficial US EPA/DOE fuel-economy, fuel-cost, and emissions data for a vehicle by year + make + model. Returns one entry per powertrain configuration: MPG city/highway/combined (MPGe for EVs), CO2 grams/mile, annual fuel cost, annual petroleum barrels, EPA greenhouse-gas score, 5-year savings vs average, transmission, drivetrain, cylinders, displacement, fuel type, size class, EV range. Authoritative EPA figures; keyless, public-domain, 1984+.
vehicle.canadian-specsCanadian-market vehicle dimensions/weights from NHTSA vPIC Canadian Vehicle Specifications. Pass year + make (required) + optional model. Returns labeled dimensions — overall length/width/height (cm), wheelbase, curb weight (kg), track width, interior room, weight distribution — plus the raw spec map. Keyless, public-domain, 1971+.
security.cve-changesCVE change feed — the CVE records MODIFIED within a time window, so an agent can incrementally maintain a vulnerability view instead of re-scanning. Pass since (YYYY-MM-DD or ISO datetime); until defaults to now (window ≤120 days). Optional keyword/cpe filter. Each result: id, published + lastModified, vulnStatus, CVSS score/severity, description, and kevListed (now on the CISA Known-Exploited catalog). Newest first. Live NVD + CISA KEV, keyless. Pairs with security.cve for full detail.
finance.amortizeCompute a loan or mortgage amortization schedule. Pass principal, annualRatePct (e.g. 6.5), and term as termMonths or termYears; optional extraMonthly adds extra principal each month. Returns the fixed monthly payment, total interest, total paid, payoff month count, and the full month-by-month schedule (payment/principal/interest/balance). Deterministic, no external calls.
email.validateValidate an email address: RFC syntax validity, normalized address with local/domain, and flags for isDisposable (throwaway domain), isRoleAccount (info@/support@/…), isFreeProvider (gmail/outlook/…). With checkMx (default true) also reports hasMxRecords (domain MX presence, via DNS-over-HTTPS) + MX hosts. NOT a deliverability or mailbox-existence guarantee — signals only. For signup hygiene and lead scrubbing.
travel.advisoryCurrent US State Department travel advisories. Omit country for the full list, or pass a country name (case-insensitive substring) for one. Returns the advisory level (1 Normal Precautions → 4 Do Not Travel) with label, a plain-text summary of reasons, the official link, and published date. Live from the official travel.state.gov RSS feed (public domain).
travel.visaVisa requirement for a passport × destination. Pass passport and destination as ISO-3166 alpha-3, alpha-2, or country name. Returns the category — visa free (with visaFreeDays), visa on arrival, e-visa, eta, visa required, or no admission — plus a plain-language description. Community-maintained Passport Index dataset (MIT); informational, not official immigration advice.
medical.drug-priceUS drug pricing from CMS NADAC (National Average Drug Acquisition Cost), the benchmark per-unit acquisition cost CMS surveys weekly. Pass ndc (11-digit NDC) for an exact product or name (e.g. 'atorvastatin 10 mg') to search. Returns NDC, description, nadacPerUnit (USD), pricingUnit, effectiveDate, OTC flag, brand/generic classification — newest first. Real surveyed acquisition costs (not retail/insured price). Public domain; current-year dataset auto-resolved.
domain.intelDomain intelligence in one call — composes DNS (A/AAAA/MX/NS/TXT), WHOIS/RDAP (registrar, dates, status, nameservers, DNSSEC), and the live TLS certificate (issuer, validity, SANs, fingerprint) for a domain. Returns a summary (resolves, has MX, registrar, domain expiry, HTTPS valid, days to cert expiry) plus a found/error block per section. For domain due diligence, security recon, and expiry monitoring.
business.kyb-360Full Know-Your-Business (KYB) intelligence dossier on a company in one call. Pass name (company name); optional state narrows federal awards, optional ticker pulls SEC EDGAR identity + filings. Fans out to SAM registration, SAM exclusions (debarment), OFAC sanctions, GLEIF LEI, USAspending awards, FARA foreign-agent registration, and USPTO trademarks owned. Returns riskFlags + a cleared boolean (debarment+sanctions), a summary of every signal, and a found/error block per source. For vendor onboarding, KYB/AML, and procurement due diligence. Probabilistic name matching — verify with a hard identifier before acting.
edi.ackGenerate the ANSI X12 997 Functional Acknowledgment for a received EDI interchange. POST edi with the raw inbound interchange (the 850/810/856 you received); returns the ready-to-send 997 in meta.ack — sender/receiver mirrored, delimiters echoed, one ST(997) per inbound functional group with correct AK1/AK2/AK5 and AK9 included/received/accepted counts. status controls the response: A=Accepted (default), E=Accepted with errors, P=Partial, R=Rejected, M/W/X=auth/security rejection. Deterministic, no external calls — the reply leg of EDI.
edi.generateGenerate an outbound ANSI X12 EDI document from JSON. POST type (850 = Purchase Order, 810 = Invoice) + senderId, receiverId, documentNumber (PO#/invoice#), optional date, parties (N1 role+name), items (quantity, uom, price, productId); for 810 optionally poNumber + total. Returns the full X12 interchange in meta.edi (correct ISA/GS/ST…SE/GE/IEA envelope). Deterministic — the outbound complement to edi.parse + edi.ack.
factcheck.searchSearch the global corpus of published fact-checks (ClaimReview) by claim text. Returns matching claims with the claimant, claim date, and each review's verdict (textualRating like "False"/"Misleading"/"True"), publisher (PolitiFact, Snopes, FactCheck.org, Reuters, AFP…), review URL and date. Covers all topics — politics, health, science, viral/misinformation. Optional language, maxAgeDays, and publisher-site filters. Check whether a claim was fact-checked + how it was rated instead of asserting from training.
aviation.metarCurrent aviation weather observation (METAR) for airports. Pass ids (comma-separated ICAO, e.g. KATL,EGLL). Returns raw METAR + decoded flight category, temp/dewpoint, wind, visibility, altimeter, clouds. Source: NOAA Aviation Weather Center (keyless).
aviation.tafTerminal Aerodrome Forecast (TAF) for airports — the official ~24–30h aviation forecast. Pass ids (comma-separated ICAO). Returns raw TAF + issue time. Source: NOAA Aviation Weather Center (keyless).
aviation.sigmetActive in-flight weather hazard advisories (SIGMETs/AIRMETs) from the NOAA Aviation Weather Center. Returns current advisories over a 1-24h window, optionally filtered by hazard (CONVECTIVE, TURB, ICE, IFR, MTN OBSCN, ASH). Each carries issuing office, type, hazard, severity, valid-from/to, altitude band (ft MSL), movement (dir/speed), and raw bulletin. Keyless, public-domain. The active-hazard layer beyond aviation.metar/taf. Not for navigation.
aviation.accidentsSearch NTSB civil aviation accident/incident history (CAROL database). Filter by registration (N-number), state, make, model, city, and/or date range (dateFrom/dateTo YYYY-MM-DD). Returns events with date, location, aircraft, injury severity/counts, flight phase, and an NTSB report URL. Free, US public-domain. At least one filter required.
health.disease-surveillanceCurrent US disease surveillance from the CDC (NNDSS weekly notifiable-disease counts, MMWR 2022→current). Filter by condition (substring), location (state/region/territory/national), and/or year; weeks/limit page results. Returns current-week count, prior-52-week max, and cumulative YTD per condition+location+week. Free, keyless CDC data. At least one of condition/location required.
dev.rfcLook up an IETF RFC by number. Returns status (e.g. INTERNET STANDARD/PROPOSED STANDARD), title, authors, date, stream, DOI, and the obsoletes/obsoleted-by/updates/updated-by relationship chain. Bundled RFC index (~9.8k RFCs); anti-hallucination on RFC status/relationships.
dev.preflightCheck whether a shell command is runnable before running it — a pre-execution gate for agent-generated commands. POST command (curl/wget/httpie or anything with a URL). Parses out method, target URL, and headers and returns a structured verdict: verdict ('runnable'/'invalid'), runnable boolean, and a checks breakdown (hasTarget, urlValid, schemeOk, hostPresent, methodValid, privateTarget). Default is STATIC + deterministic (no network) — a command with no URL is invalid. Pass probe=true to also run a guarded HEAD against the target and report dnsResolves/reachable/tlsValid/httpStatus. Private/loopback targets are refused (SSRF-safe).
water.gaugeReal-time US river/stream conditions from a USGS monitoring site. Pass site (USGS site number, e.g. 01646500). Returns latest streamflow, gage height, water temp + site name/location. Source: USGS NWIS (keyless).
crypto.defiDeFi total-value-locked (TVL) via DefiLlama. No params → top protocols by TVL (name, category, TVL, 1d/7d change, chains) + total DeFi TVL. protocol=<slug> (e.g. lido, aave, uniswap) → one protocol; chain=<name> (e.g. ethereum, solana) → that chain's TVL. Distinct from crypto.markets (spot prices) — protocol/chain capital locked. Free, keyless.
crypto.contractDecode an EVM smart contract. Pass chain (ethereum, base, polygon, arbitrum, optimism, bsc, avalanche) + address → whether source-verified (Sourcify), name/compiler/language, proxy + implementation, and human-readable function/event signatures from the ABI. Optional selector (0x 4-byte) → decode what it calls (from the contract ABI if verified, else the 4byte directory). Pairs with crypto.tx. Free, keyless.
crypto.fear-greedCrypto Fear & Greed Index — 0–100 market sentiment (0 = Extreme Fear, 100 = Extreme Greed), updated daily, with classification. Pass limit (1–90) for recent history. Contrarian sentiment signal. Source: alternative.me.
crypto.marketsTop cryptocurrencies by market cap with live price, market cap, 24h volume, and 24h + 7d % change. Pass limit (1–100, default 20). Source: CoinGecko. Single token = crypto.token-price; market overview = crypto.global.
crypto.globalWhole-crypto-market overview: total market cap, 24h volume, 24h change, BTC + ETH dominance, active-coin count. Source: CoinGecko.
crypto.trendingMost-searched trending cryptocurrencies right now (24h), with symbol, name, market-cap rank, price. Attention signal. Source: CoinGecko.
geo.elevationGround elevation above sea level (meters + feet) for any coordinate on Earth. Pass lat + lon. ~90m DEM. Source: Open-Meteo (keyless).
trade.tariffLook up or search the US Harmonized Tariff Schedule (HTS / HS codes). Pass code for an exact HTS number (returns the line + 10-digit stat suffixes with duty rates), or query for free-text → ranked candidate HS codes by hierarchical heading. ~29.6k public-domain USITC lines. The deterministic backbone for tariff classification.
trade.locodeLook up or search UN/LOCODE — the UN Code for Trade and Transport Locations (~116k locations, all countries). Pass locode for an exact code (e.g. USNYC), or query to search names with optional country (ISO alpha-2) and function (port, rail, road, airport, postal, multimodal, fixed, border) filters. Returns name, subdivision, transport functions, status, IATA code, coordinates. The standard location identifier in shipping, EDI, and customs documents.
trade.flowsAnnual international merchandise-trade flows from UN Comtrade (HS classification). reporter = country whose trade you want (ISO-2/ISO-3 'US'/'USA', UN M49 number, or 'World'); optional partner (default World); year (YYYY); flow (export|import); commodity = 'TOTAL' (default), a specific HS code ('27','8703'), or 'AG2'/'AG4'/'AG6' for a top-commodity breakdown. Returns trade value (USD), net weight, quantity, HS commodity, sorted by value.
crypto.gas-oracleLive EVM gas oracle. Returns slow/standard/fast tiers derived from priority-fee percentiles over the trailing 4 blocks plus a 21,000-gas transfer cost estimate. Chains: base, ethereum, polygon, arbitrum, optimism.
crypto.btc-feesCurrent Bitcoin network fee rates and mempool backlog from mempool.space. Returns recommended fee rates (sat/vByte) for fastest/half-hour/hour/economy/minimum confirmation, plus mempool size (tx count, vsize, total fees waiting). Keyless, live. The BTC counterpart to crypto.gas-oracle.
ai.summarizeSummarize a webpage. Returns a short summary, 3-7 key points, title, audience, and reading time. Backed by an upstream LLM.
ai.translateTranslate text into a target language. Source language auto-detected if omitted.
ai.extractFetch a URL and extract typed data from its content per a user-supplied JSON Schema. Use when you need a structured payload conforming to your own shape.
ai.describe-imageDescribe an image (JPEG/PNG/GIF/WebP, ≤1MB) via Claude Haiku vision. Returns caption + structured details.
ai.screenshotTake a headless-browser screenshot of a URL. Returns base64 image + size metadata.
health.provider-profileProvider 360 by NPI — merges NPPES identity (name, specialty, address, licenses) + CMS Open Payments (industry payments) + CMS Medicare billing in one call. Each section reports found/error independently. KYC, healthcare-fraud, provider due diligence.
vehicle.profileVehicle 360 by VIN — decodes the VIN (make/model/year/trim/engine, NHTSA vPIC) then returns THAT vehicle's open safety recalls and owner complaints, keyed to the decoded make/model/year. Used-car due diligence, fleet safety, insurance.
finance.company-profileCompany 360 by ticker — merges recent SEC filings + curated XBRL fundamentals (revenue, net income, EPS, assets) + recent insider (Form 4) transactions in one call. Equity research, due diligence, monitoring.
space.bodyAsteroid/comet physical + orbital parameters from NASA JPL Small-Body Database by designation, number, or name (e.g. "433 Eros", "1P/Halley", "2024 YR4"). NEO/PHA flags, diameter, albedo, orbit class, eccentricity, period, Earth MOID.
space.close-approachesNear-Earth asteroid/comet close approaches to Earth in a date window + max distance (NASA JPL CAD). Returns designation, date, distance (AU + lunar distances), relative velocity, magnitude. Sorted nearest-first.
space.satelliteCurrent position of any cataloged satellite by NORAD number (e.g. 25544=ISS) via fresh Celestrak elements + SGP4. Returns sub-point lat/lon/altitude + speed; pass observer lat/lon for azimuth/elevation/range look angles.
space.satellitesSearch the catalog of ~69k cataloged Earth-orbiting objects (CelesTrak SATCAT). Filter by name (q, e.g. "starlink"), owner/launching country (owner = US/PRC/CIS… or a name), object type (payload|rocket body|debris|unknown), launch-year range, intlDesignator prefix, on-orbit vs decayed, or exact noradId. Each row has NORAD id, name, owner+country, launch/decay dates, and orbital params. The envelope total is the full count matching the filter — so onOrbit=true&type=payload answers "how many active satellites".
space.launchesUpcoming or recent orbital rocket launches (Launch Library 2). when=upcoming|previous, optional search by rocket/provider/mission. Returns name, status, launch time + window, provider, rocket, pad, mission, webcast.
space.sky-tonightObserver-local sky almanac for a lat/lon + time (computed, no upstream): sun & moon rise/set + current alt/az, moon phase + illumination + next quarter, and all 7 naked-eye planets (alt/az, RA/dec, magnitude, above-horizon). Stargazing, astrophotography.
space.exoplanetConfirmed exoplanets from the NASA Exoplanet Archive (~6k, weekly). Filter by name, hostStar, discoveryYear, or method. Returns orbital period, radius/mass (Earth units), equilibrium temp, host-star params, distance (parsecs + light-years).
bio.speciesResolve any organism (scientific or common name) to the GBIF taxonomic backbone: accepted name, full lineage (kingdom→species), vernacular names, global occurrence count, GBIF link. Fuzzy-matches misspellings.
bio.geneGene lookup by symbol + organism (taxid, default 9606=human): NCBI Gene identity (description, chromosome, map location, aliases, RefSeq summary) joined with UniProt protein (accession, name, length, function).
space.skywatchSynthesis — what is notable in YOUR sky right now (lat/lon): the live almanac (sun, moon phase, planets above your horizon), near-Earth asteroid close approaches this week, and the ISS (position + whether it is above your horizon now). One call, three sources, per-section found/error.
space.systemSynthesis — profile a confirmed exoplanetary system by host-star name (e.g. "TRAPPIST-1"). Groups the star's planets, summarizes the host star, and COMPUTES the habitable zone (inner/outer AU from stellar luminosity), flagging which planets fall in it.
space.observeWhere is an asteroid/comet in the sky and can you see it? Propagates JPL orbital elements (validated vs Horizons to <0.1 arcmin) to give geocentric RA/Dec, constellation, distance, phase angle, and apparent magnitude. With observer lat/lon: altitude/azimuth, visible-now flag, and the best dark-sky viewing window in the next 24h.
bio.proteinFull UniProtKB protein entry by accession (e.g. P04637): names, gene, organism, sequence length + molecular weight, function, subcellular locations, GO terms, PDB structures, keywords. Protein-centric sibling to bio.gene.
business.entity-screenKYC in one call: look up a business in a US state registry (NY/CO/CT) AND screen it + its registered agent against OFAC sanctions. Returns matched entities each with a sanctions screen (confidence + flagged). Counterparty due-diligence, AML. Probabilistic name match.
crypto.ens-resolveResolve ENS live on Ethereum mainnet: pass an ENS name (e.g. "vitalik.eth") to get its address, or a 0x address to get its primary ENS name (reverse). Also returns avatar, email, url, twitter, github, description text records. On-chain lookup agents can't do from a sandbox.
html.to-markdownConvert raw HTML you already have into clean reading markdown (no URL fetch). POST { html }. Strips scripts/nav/ads, extracts main content, preserves headings/links/lists. For fetching a live URL use url.clean instead.
tls.cert-infoOpen a live TLS connection to a host and return its certificate: protocol + cipher, chain validity, leaf subject + issuer, valid-from/to, days-until-expiry, serial, SHA-256 fingerprint, SANs, chain length. Active probe; SSRF-guarded. Cert-expiry monitoring, TLS audits.
law.docket-searchSearch US federal court dockets (civil + criminal) from the RECAP/PACER archive. q full-text (case/party name) with optional court id + filed date range, or exact docketNumber. Returns case name, court, docket number, dates, judge, docket URL.
gov.inmate-locatorFederal Bureau of Prisons inmate search, 1982-present (current + released). By lastName (+ firstName/age/sex/race) or exact BOP register number. Returns name, register number, facility, projected/actual release dates.
gov.lobbying-filingsUS federal lobbying disclosures (Senate LDA) — who lobbies for whom, on what issues, for how much. Filter by registrant (firm), client, lobbyist, year, period, type. Returns income/expenses, registrant + client, issues, document URL.
gov.congress-filingsTrack US House members' financial-disclosure filings incl. Periodic Transaction Reports (PTRs — the STOCK Act stock-trade disclosures). Defaults to PTRs; type=annual|candidate|amendment|all for others. Filter by member name (q), state, year, or filing-date range. Returns member, state+district, filing type+label, filing date, and a direct link to the source document. The envelope total answers 'how many PTRs'. 2008→present, refreshed daily. Trades are disclosed up to 45 days after they happen — current-to-the-filing, not real-time.
gov.congress-tradesSearch individual US Congress member stock trades parsed from STOCK Act PTRs into clean rows. Filter by member (q), ticker (e.g. NVDA), type (purchase|sale|exchange), state, chamber, or transaction-date range. Each trade: member + state/district, owner (self/spouse/joint), ticker + asset, buy/sell, the disclosed dollar RANGE (amountMin/amountMax — ranges, not exact), transaction + disclosure dates, days-to-disclose, and a link to the source filing. envelope total answers 'how many bought NVDA'. Amounts are ranges; trades disclosed up to 45 days after they happen. Coverage: US House e-filed now, expanding to scanned + Senate.
health.mortality-statsUS mortality statistics (CDC NCHS). dataset=leading-causes: annual deaths + age-adjusted rate by state and top-10 cause, 1999-2017. dataset=weekly-counts: provisional weekly deaths by jurisdiction + cause, 2020-2023.
health.hospital-qualityCMS Care Compare hospital quality ratings (~5,300 Medicare-certified US hospitals): overall star rating + mortality/safety/readmission/patient-experience measure summaries. By facilityId, or state/city/name filters.
health.medicare-providerMedicare utilization + payments by provider (CMS annual dataset): beneficiary counts, total services, submitted charges, Medicare payment amounts per NPI. By npi, or lastName + state. Pairs with health.open-payments.
business.sos-searchState Secretary-of-State business registry search, normalized across states (currently NY, CO). By name (partial) or exact entityId. Returns entity id, name, type, status, jurisdiction, formation date, address, registered agent.
business.br-cnpjBrazilian company registry lookup by CNPJ (14-digit company tax ID). Returns legal + trade name, registration status, start date, legal nature, size, share capital (BRL), primary CNAE activity, contact, address, and partners/officers (QSA). Free, open Receita Federal data (BrasilAPI). KYB/diligence for Brazilian companies.
business.uk-companiesOfficial UK company registry (Companies House). Pass query to search by name, or companyNumber for the full profile — legal name, status, type, jurisdiction, incorporation/cessation dates, SIC codes, registered office, accounts + confirmation-statement due dates, charges/insolvency flags, previous names, and officers (name, role, appointed/resigned, nationality, occupation). Free, Open Government Licence. Authoritative UK KYB lookup.
business.entity-profileFull business-entity dossier from a state registry — master record plus officers/principals, registered agent (name, phone, email, address), and filing history. v1 state: CT (Connecticut). Resolve by entityId (registry record id), accountNumber, or name (partial; most recent registration wins). Returns status, type, registration date, mailing address, minority/woman/veteran/disability/LGBTQI ownership flags, officers, registered agent, and recent filings. KYB / counterparty due-diligence; official state open-data portal.
business.naicsNAICS 2022 industry classification codes (US Census, public domain). Pass code for an exact NAICS code (2-6 digits, or a sector range like 31-33) → official title, hierarchy path, full description, activity index terms, and direct child codes. Or pass query for free-text search over titles + the official ~20k-entry activity index → ranked candidate codes, optionally filtered by level (2=sector … 6=national industry). Ground truth for industry coding in KYC, registrations, and ERP setup.
business.leiLook up or search the global LEI (Legal Entity Identifier) registry — the authoritative ISO 17442 directory of ~2.6M legal entities worldwide (GLEIF, CC0). Pass lei for an exact 20-character LEI, or query to search by legal/other name (ranked best-match). Filter name search by country (HQ ISO 2-letter) and status (active|all). Returns LEI, legal name, jurisdiction, entity category, legal-form code, entity + registration status, HQ address, registration/renewal dates, and managing LOU. Canonicalize a company name to its LEI, resolve a counterparty, or enrich a vendor master.
business.entity-matchFuzzy entity resolution: resolve a messy, free-text company name to its canonical GLEIF Legal Entity Identifier (LEI) with a 0-1 similarity score and high/medium/low confidence. Tolerant of legal-suffix noise (Inc/Ltd/GmbH/S.A.), word order, ampersands, punctuation, and former/alternate names (e.g. 'Apple Computer Inc' → Apple Inc.). Returns ranked candidates plus a single bestMatch (null below medium confidence — safe for KYB). The record-linkage complement to business.lei. Optional country (ISO-2) narrows the jurisdiction.
edu.school-lookupEvery US public K-12 school (~102k, NCES Common Core of Data). Search by name/district (partial), state, city, zip, or exact 12-digit NCES id. Returns address, level, type, charter/magnet/virtual flags, enrollment, grade span.
license.tradesUS trade/occupational license verification (currently TX TDLR: electricians, A/C techs, cosmetologists, tow operators, +40 trades). By name (owner/business, partial), licenseNumber, licenseType, county. Returns type, number, names, expiration.
license.real-estateUS real-estate license verification (currently TX TREC: brokers, sales agents, broker companies). By name (partial), licenseNumber, licenseType, status. Returns type, number, holder, status, dates, supervising broker.
law.case-searchSearch US federal + state case law (CourtListener / Free Law Project).
law.case-verifyVerify every US legal citation inside a passage of text against the real CourtListener corpus. Anti-hallucination check before quoting case law.
law.citation-checkAnti-hallucination checker for legal references. POST text to verify every cited case (CourtListener), US Code section, and CFR regulation EXISTS, with canonical metadata + source URLs. POST quotes:[{citation,quote}] to deterministically verify an attributed QUOTE actually appears in the cited opinion (ellipsis-aware) — catches fabricated quotations. Returns per-reference exists/quote-present + a summary. Checks facts (existence, quote presence), NOT whether a case legally supports a proposition.
law.sanctions-checkFuzzy-match a name (person, company, vessel, aircraft) against the US Treasury OFAC SDN list. Returns ranked matches with similarity scores and sanctions program metadata. List refreshed daily.
law.federal-registerSearch US Federal Register documents (proposed rules, final rules, notices).
law.cfr-sectionFetch the authoritative full text of a US Code of Federal Regulations section by title + section number (e.g. title 17, section 240.10b-5). Optional date (yyyy-mm-dd, back to 2017) returns the historical text in force on that date. Returns citation, heading, plain text, Federal Register source credit, and official eCFR link. Public-domain, updated daily.
law.opinionFetch the full text of a US court opinion by CourtListener opinion ID OR by citation. Returns plain text + case metadata. Supply exactly one of opinionId or citation.
law.attorney-lookupCourtListener attorney search by name and/or firm. Returns parsed attorney records with firm name, contact info, and CL IDs. Supply at least one of name or firmName. Case-insensitive matching via Title-Case + startswith.
law.judge-lookupCourtListener federal judge lookup by name. Returns parsed judge records with biographical data (DOB, DOD, FJC ID). Useful for venue research, judicial profile lookup, and bio enrichment.
law.usc-sectionFetch the authoritative current text of a United States Code section by title + section number (e.g. title 17, section 107 = fair use). Returns citation, heading, hierarchy context, full statutory text, Statutes-at-Large source credit, and the official OLRC link; includeNotes adds amendment history. Handles hyphenated/lettered sections like 1395w-4 or 78j. Verify statutory citations instead of relying on model memory. Public-domain.
law.trademark-statusVerify a US trademark by USPTO serial number (8 digits) or registration number: word mark, LIVE/DEAD status with detail and dates, current owner, mark type, and international classes covered. Authoritative real-time USPTO TSDR data — confirm a mark exists and is active instead of trusting model memory. Number lookup only (no text search).
nutrition.foodUSDA FoodData Central nutrition lookup (~400k foods). Search by name (query=cheddar cheese) for matching foods with fdcId, or fetch one food (fdcId=328637) for its full analyzed nutrient profile — energy, protein, fats, carbs, vitamins, minerals with amounts and units, plus ingredients for branded foods. Real analyzed values instead of model-estimated nutrition facts.
tld.infoTLD registry + Public Suffix List intelligence. tld=io returns IANA root-zone metadata (type, managing organization, unicode form). domain=shop.example.co.uk runs the full PSL algorithm: effective public suffix, registrable domain, subdomain, matched rule, and whether the suffix is ICANN or private/corporate (github.io, s3.amazonaws.com). For cookie scoping, per-registrant rate limiting, URL dedup, and abuse analysis.
climate.station-historyHistorical daily weather observations (NOAA GHCN-Daily) for one station + date range (≤366 days): max/min/avg temperature °C, precipitation/snow mm, wind m/s. Records back to the 1800s — actual measured values for "what was the weather on this date". Find a station id with climate.station-near first.
search.webLive web search: ranked results with title, URL, snippet, site name, and page age — fresh information past any training cutoff. Supports paging (count/offset), country, freshness (pd/pw/pm/py or date range), safesearch. Use for current events, fact verification, documentation, research.
security.cveLook up a CVE by id (e.g. CVE-2021-44228) across three authoritative vulnerability feeds in one call: the canonical record (description, CVSS base score + severity + vector, CWE ids, dates, references), whether it is on the US CISA Known Exploited Vulnerabilities catalog (with remediation due date + known-ransomware flag), and its EPSS exploit-probability score + percentile. The exploited and EPSS sections degrade independently. 404 if unknown. For vulnerability triage, prioritization, and anti-hallucination. Sources: NIST NVD, CISA KEV, FIRST.org EPSS.
security.packageSecurity + provenance for an open-source package, composed live in one call from OSV (known vulnerabilities — aggregates GitHub Security Advisories, PyPA, RustSec, Go vuln DB, etc., each with CVE aliases + severity + references), deps.dev (resolved license + deprecation), and OpenSSF Scorecard (source-repo health: overall 0-10 + per-check, plus stars/forks/open-issues). Pass ecosystem (npm/pypi/go/maven/cargo/nuget) + name (+ optional version). Live — new advisories appear within hours. Distinct from registry.npm/pypi-lookup (metadata only): "is this dependency safe to add, what license, how well-maintained."
security.cve-searchFind CVEs affecting a product by searching the NIST NVD. Pass product (free-text keyword, e.g. "apache log4j", "openssl") or cpe (exact CPE 2.3 name). Returns matching CVEs newest-first with id, description, CVSS score/severity/vector, dates. Optional limit (1-50). For "what CVEs affect X" — distinct from security.cve (resolve one id across NVD+KEV+EPSS). Free, keyless.
news.searchLive news search: recent headlines with publisher source, relative age, and breaking flag. freshness narrows recency (pd=past day, pw, pm, py). Use for current events and monitoring.
crypto.token-priceCurrent spot price, market cap, 24h volume and 24h change for crypto assets by CoinGecko asset id (lowercase, e.g. "bitcoin,ethereum,solana" — not ticker symbols). vs sets quote currencies (default usd). Price data by CoinGecko.
flight.statusLive flight status by flight designator (UAL1 / UA1) or tail number: origin/destination airports, status, cancellation/diversion, scheduled vs estimated vs actual gate + runway times, delays, progress percent, aircraft type and registration. Answers "where is this flight, is it delayed, when does it land".
transcribe.audioTranscribe an audio file URL to text (wav, mp3, m4a, ogg/opus, flac, webm; ≤15 MB, ≤15 minutes — split longer recordings). Returns punctuated transcript, confidence, duration, detected language, word-level timestamps, and (diarize=true) speaker-segmented utterances.
person.cross-registrySweep a person name across five US public registries in one call: FINRA brokers, federal-court attorneys, federal inmates (BOP), Texas trade licenses, Texas real-estate licenses. Per-registry found/error blocks with matching records — name-matched CANDIDATES, not identity-resolved (verify with each registry's identifier). Due-diligence and background-research triage.
geo.nearbyEverything around a coordinate in one call: nearby airports, public K-12 schools, NOAA climate stations, and past-week earthquakes, each with distance and an independent found/error block. radiusKm default 25 (max 200), limit per category. Site assessment, relocation research, risk screening.
stocks.quoteLatest daily stock quote for a US-listed ticker (e.g. AAPL, MSFT, BRK.B): open/high/low/close, volume, VWAP, trade count, change and percent change vs the prior session, plus company name, exchange, security type, and market cap. NOTE: end-of-day / delayed data (response flags delayed=true) — for daily snapshots and post-close analysis, not real-time trading. Market data by Massive (formerly Polygon.io).
medical.rxnormNormalize and verify drug names against RxNorm, the canonical US drug vocabulary (NIH). term="tylenol 500mg" returns ranked RxCUI candidates with normalized names (typos tolerated); rxcui=… returns the canonical concept plus related ingredients, brand names, and dose forms. Verify drugs exist and get stable identifiers instead of trusting model memory. Sibling of medical.icd10.
nonprofit.screenLook up US 501(c) nonprofits and screen each against the OFAC sanctions list in one call: registry record (EIN, name, location, NTEE) + per-org sanctions block (flagged, match count, SDN matches with confidence). Grant-making due diligence and donation compliance.
finance.sec-filingsRecent SEC filings (10-K, 10-Q, 8-K, etc.) for a US public company by stock ticker. Returns parsed company info + a list of filings with accession numbers, forms, dates, primary document URLs. Backed by SEC EDGAR public submissions API.
finance.company-factsCurated XBRL financial metrics for a US public company by stock ticker. Returns ~15 top-line metrics (revenue, gross profit, operating income, net income, EPS, R&D, total assets, liabilities, equity, cash, debt, operating cash flow, capex, shares outstanding) with their most recent annual + quarterly values. Each metric returns the originating form (10-K/10-Q), period dates, fiscal year/period, and filed date.
finance.xbrl-framesSEC EDGAR XBRL Frames — one financial concept across ALL public filers for one period, for cross-company screening. Give an XBRL tag (Revenues, NetIncomeLoss, Assets), period (CY2023 annual, CY2023Q1 quarter, CY2023Q4I instant), optional unit (default USD), and get every filer's value (company, CIK, location, period, value) sorted high-to-low (or asc), plus total filer count. Free, public-domain (SEC). Distinct from finance.company-facts (one company, many metrics) — this is one metric across all companies.
finance.insider-tradesRecent SEC Form 4 insider transactions for a US public company by ticker. Returns parsed transactions: insider name + relationship (director, officer/title, 10%+ owner), date, SEC transaction code (P=purchase, S=sale, A=grant, D=disposition, M=exercise, F=tax-withholding, G=gift), security title, shares, price/share, total USD value, post-transaction balance, direct vs indirect ownership, derivative flag.
finance.ifsc-indiaIndian bank branch lookup by IFSC code (11-char Indian Financial System Code). Returns bank + branch, centre, district, state, city, address, contact, MICR, and supported payment rails (IMPS/RTGS/NEFT/UPI). Free, open data. Deterministic bank-branch reference for India payments/KYC.
finance.binIdentify a payment card from its BIN/IIN (leading 6-8 digits). Pass the BIN or leading card digits and get card brand (Visa/Mastercard/…), card type (debit/credit), category, issuing bank, and country (ISO alpha-2 + name). Longest-prefix match against an open CC-BY dataset. Identifies issuer/brand/country only — never the cardholder or account. For payment routing, fraud checks, checkout UX.
finance.figiMap a security identifier to its FIGI (Financial Instrument Global Identifier) + metadata via OpenFIGI. Give idType (ISIN, CUSIP, SEDOL, TICKER, FIGI, COMMON, WKN, CINS, or raw OpenFIGI ID_* type) and idValue, optionally narrowed by exchCode/currency. Returns each listing with FIGI, composite/share-class FIGI, name, ticker, exchange, security type, market sector, description. Free, open symbology (Bloomberg OpenFIGI).
finance.figi-searchFree-text security search across global exchanges via OpenFIGI. Give a query (name/ticker/description), optionally narrow by exchCode/securityType/marketSector (Equity, Corp, Govt, Mtge, Muni, Pfd, Comdty, Index, Curncy). Returns relevance-ranked FIGIs + metadata and a next cursor (pass back as start). Free, open symbology. Distinct from finance.figi (exact id → FIGI) — this is discovery by name.
finance.thirteen-fParsed institutional holdings (Form 13F-HR) for an investment manager by CIK. Returns each holding's nameOfIssuer, cusip, market value (USD; converted from SEC's $000s convention), shares or principal amount + type, putCall flag for options, and voting authority (sole/shared/none). Sorted by value descending. Common manager CIKs: Berkshire Hathaway=1067983, Renaissance=1037389, Bridgewater=1350694, Vanguard=102909, BlackRock=1364742.
airport.lookupLook up an airport by IATA (3-letter) or ICAO (4-letter) code. ~85k airports (CC0 — OurAirports).
airport.nearFind airports near a coordinate, ordered by distance.
weather.zipCurrent US weather for a ZIP code (NOAA NWS).
weather.alertsLive US National Weather Service active alerts (watches/warnings/advisories) for a point ("lat,lon") OR an area (2-letter US state or marine code). Real-time severe-weather data. Optional severity/urgency filter; sorted most-severe first.
weather.forecastOfficial US National Weather Service forecast for a coordinate (US land + territories). Pass lat + lon for ~7 days of day/night periods, or hourly=true for an hourly forecast. Each period: temperature, wind, chance of precipitation, short + detailed forecast. Keyless, public domain. For active warnings use weather.alerts.
weather.air-qualityCurrent air quality for any coordinate worldwide: US AQI (+ category) and European AQI, plus PM2.5, PM10, ozone, NO2, SO2, CO concentrations. Source: Open-Meteo/CAMS (keyless).
weather.marineCurrent marine/sea-state for an ocean or coastal coordinate: significant wave height, direction, period, plus wind-wave and swell components. Source: Open-Meteo marine (keyless). 404 for inland points.
weather.historyHistorical daily weather (ERA5, 1940→~5 days ago) for a coordinate + date range (start, end YYYY-MM-DD, ≤366 days): per-day max/min/mean temp, precipitation total + hours, max wind. Source: Open-Meteo archive (keyless).
weather.currentCurrent weather conditions for any coordinate worldwide (global — not just US): temperature, feels-like, humidity, precipitation (rain/snow), cloud cover, pressure, wind speed/direction/gusts, day/night flag, and human-readable conditions, with local time + timezone. Optional units=metric|imperial (default metric). Source: Open-Meteo (keyless). For official US-only NWS data see weather.zip / weather.forecast.
weather.forecast-globalWeather forecast for any coordinate worldwide, up to 16 days out (global — not just US). Daily items: max/min temperature, feels-like max, precipitation total + max probability, max wind + gusts, sunrise/sunset, conditions; hourly=true for hour-by-hour instead. Optional days (1-16, default 7) and units=metric|imperial. Source: Open-Meteo (keyless). For the official US-only NWS forecast see weather.forecast.
climate.station-nearFind NOAA GHCN-Daily climate stations near a coordinate. Useful for long-term climate-history lookups.
tides.nowNOAA tide predictions for the nearest tide station to a coordinate.
medical.icd10Verify an ICD-10-CM diagnosis code (with or without the dot, e.g. E11.9) or keyword-search the official US code set (FY2026, ~98k entries). Returns a verified flag, the exact match, more-specific child codes, billable status, and short/long descriptions. CMS/NCHS public-domain data, refreshed each US fiscal year. Provide exactly one of code or q.
medical.drug-statusOne-call drug situational awareness: whether a drug is currently in FDA shortage, any open/recent FDA recalls, and FDA NDC-directory metadata (labeler, DEA schedule, pharm class). Give a drug name (resolved via RxNorm), or an exact rxcui or ndc. Returns hasCurrentShortage/hasOpenRecall plus per-source found/error blocks. Free, public-domain FDA + NIH data.
medical.drug-labelAuthoritative FDA drug label (Structured Product Labeling). Give a drug name (brand/generic/substance), or an exact ndc, rxcui, or SPL setId, and get the FDA-approved label split into sections: boxed warning, indications, dosage, contraindications, warnings, adverse reactions, drug interactions, special populations, pregnancy, mechanism of action, ingredients — plus identity metadata and a hasBoxedWarning flag. Free, public-domain FDA data.
medical.drug-approvalFDA drug approval history from Drugs@FDA. Give a drug name (brand/generic), an FDA application number (e.g. NDA019872), or a sponsor, and get each approved application with its products (brand, active ingredients + strengths, dosage form, route, marketing status, TE code) and full submission history (approvals/supplements + dates, review priority). Free, public-domain FDA data.
medical.device-510kFDA 510(k) premarket clearances — medical devices cleared for US marketing via substantial equivalence. Search by device name, applicant (manufacturer), or FDA product code; returns K-number, device name, applicant, decision date + description, clearance type, product code, advisory committee, newest first. Free, public-domain FDA data.
medical.device-classificationFDA medical device classification — regulatory class and controls for a device type. Search by device name or FDA product code; returns device class (I/II/III), CFR regulation number, medical specialty/review panel, official definition, and flags for life-sustaining/support, implant, GMP-exempt, third-party-review. Free, public-domain FDA data.
medical.device-udiFDA GUDID device lookup — identify a marketed medical device by UDI/device identifier, brand, or company. Returns device description, version/model, Rx vs OTC, single-use/kit/combination flags, MRI safety, sterilization, commercial-distribution status, device identifiers (with GS1/HIBCC/ICCBBA issuing agency), FDA product codes, and GMDN terms. Free, public-domain FDA data.
medical.device-recallFDA medical-device recalls — devices removed or corrected in the US market due to a possible health risk. Search by device name, recalling firm (manufacturer), recall classification (I most serious / II / III), status (Ongoing/Completed/Terminated/Pending), or state, or omit all filters for the most recent recalls nationwide. Returns recall number, classification, status, product description + quantity, reason, code/lot info, recalling firm + location, distribution pattern, voluntary-vs-mandated, and recall/classification/report dates, newest first. Free, public-domain FDA data. Distinct from medical.device-510k (clearances) and medical.device-event (adverse-event reports).
medical.npiUS healthcare provider lookup in the CMS NPPES registry (~9.6M providers). Give an exact 10-digit NPI, or search by provider last name (+ first name), or organization name, optionally narrowed by state and taxonomy/specialty. Returns NPI, entity type (individual/organization), status, name/credential or org name, taxonomies (code + description + state license), and practice address with phone. Free, public-domain (CMS).
medical.geneticsMedlinePlus Genetics (NLM) reference for a genetic condition or gene. Give a term (e.g. "cystic fibrosis", "BRCA1") and get the authoritative NLM record: name, plain-language summary, sections (description/causes/frequency/inheritance/treatment), inheritance pattern(s), related genes, synonyms, and cross-references (OMIM/GTR/ICD-10-CM). Free, public-domain (NLM). Educational reference, not medical advice.
net.asnAutonomous System (BGP) intelligence by AS number (e.g. AS3333). Returns the AS holder/operator, IANA/RIR allocation block, whether it is announced, and live routing status: announced IPv4/IPv6 prefixes + address counts, RIS peer visibility, and observed neighbour count. RIPEstat (RIPE NCC), free. Distinct from geo.ip and dns/whois — who owns and routes an AS, observed live.
product.gtinDecode/validate a product barcode (UPC-A/EAN-13/EAN-8/GTIN-14/ISBN-13/ISSN): GS1 mod-10 check-digit validation (an LLM can't reliably compute it), symbology, GTIN-14 canonical form, and GS1 prefix → issuing GS1 member org + country (the org's country, NOT necessarily country of manufacture). Flags restricted-distribution and Bookland/ISSN ranges. Plus a FRESH best-effort product-identity lookup (name/brand/category/image) across the open Open Food/Beauty/Products/Pet Food Facts federation (ODbL) — good for food/beverage/beauty, sparse for general retail, may be null. Always live, no caching. identity=false = decode only.
net.mac-vendorResolve a MAC address (or bare OUI prefix) to its IEEE-registered hardware vendor. Accepts any format (FC:FB:FB:01:02:03, fc-fb-fb-01-02-03, fcfb.fb01.0203, fcfbfb, or a 9-hex MA-S prefix). Longest-prefix match across the IEEE MA-L/MA-M/MA-S registries, so subdivided blocks resolve to the real manufacturer. Returns the vendor, matched OUI + registry, and decoded address bits: multicast/group, locally administered, or randomized (privacy) MAC. Bundled authoritative IEEE data, free.
research.orgResolve a research organization via the Research Organization Registry (ROR). Pass id (a ROR id) or name (free-text search). Returns canonical ROR id, name, type, location (GeoNames), website, external ids (GRID/ISNI/Wikidata/Fundref), relationships, and aliases. Free, CC0. The canonical institution key in scholarly metadata.
research.authorResolve a researcher by ORCID iD. Returns name, affiliations (employments + educations with a current flag), a works count, and a works summary (title, type, year, DOI). Free, keyless ORCID Public API. The canonical author key in scholarly metadata.
research.fundingSearch US federal biomedical research grants via NIH RePORTER. Filter by term (title/terms/abstract), org, pi, and/or fiscalYear. Returns awards with project number, title, fiscal year, award amount, PI, organization, funding agency, and dates — newest first, with a total count. Free, public-domain.
geo.flood-zoneFEMA flood zone for a coordinate (lat/lon). Returns the FEMA flood zone code (AE, VE, X, …), Special-Flood-Hazard-Area flag (isSFHA — the 1% annual-chance floodplain where flood insurance is mandatory), a plain-language risk level + description, base flood elevation, and source FIRM panel. FEMA NFHL, free and keyless.
geo.location-dossierStatic risk & context dossier for a US location. Pass lat+lon or a US address (geocoded for you); optional zip adds ACS demographics. Composes five keyless federal sources: Census place context (county/state/tract/congressional district), FEMA flood zone + SFHA status, USGS ASCE 7-16 seismic design parameters (Ss/S1/SDS/SD1/seismic design category/PGA), the nearest NOAA/GHCN climate station, and Census ACS 5-year demographics (zip only). Each layer is isolated. The slow-moving structural-risk picture for siting/insurance/diligence — distinct from real-time weather/earthquake conditions.
gov.contract-opportunitiesSearch ACTIVE US federal contract opportunities (solicitations, RFPs/RFQs, sources-sought) from SAM.gov. Requires postedFrom + postedTo (MM/DD/YYYY, ≤1yr span); optional title, naics, state, setAside, ptype. Returns notice id, title, solicitation number, type, department, deadline, NAICS, set-aside, office location, and a sam.gov link. Free, public-domain. Distinct from gov.usaspending-awards (past) — this is what is OPEN to bid now.
gov.entityLook up entities registered to do business with the US federal government in SAM.gov. Search by ueiSAM, cageCode, or legalBusinessName. Returns UEI, CAGE, legal/DBA name, registration status + dates, an active-exclusion flag, address, and business types. Free, public-domain. The federal counterparty identity key.
gov.exclusionsCheck whether a person or company is excluded (debarred/suspended) from US federal contracts, grants, or assistance — the SAM.gov Exclusions list. Search by name, ueiSAM, cageCode, classificationType. Returns each exclusion with classification, type, program, excluding agency, dates, and address. Free, public-domain. Distinct from law.sanctions-check (OFAC).
gov.counterpartyFederal counterparty due-diligence dossier on one name, in a single call: SAM registration + SAM exclusions (debarment) + OFAC SDN sanctions + GLEIF LEI + USAspending federal awards + FARA foreign-agent registration. Returns headline riskFlags (federally_debarred, sanctions_high_confidence_match, registered_foreign_agent), a cleared boolean (debarment+sanctions only — FARA is context), a summary, and per-source found/error blocks. Free, public-domain. The federal counterpart to business.entity-screen.
gov.foreign-agentsSearch currently-active FARA (Foreign Agents Registration Act) registrants by name. Returns whether the entity is a registered foreign agent (isRegisteredForeignAgent), a KYB-safe bestMatch (null below medium confidence — no false positives), and scored candidates with registration number, date, and city/state. FARA registration is a US disclosure status (acting for a foreign principal), not wrongdoing. DOJ FARA eFile, free and keyless.
gov.risk-indexFEMA National Risk Index for a US county — the authoritative natural-hazard risk profile. Look up by countyFips (5-digit STCOFIPS), state + county name, or a lat/lon point. Returns the composite Risk Index score/rating/national-percentile (18-hazard model = Expected Annual Loss × Social Vulnerability ÷ Community Resilience), each component, and per-hazard risk ratings + expected annual loss for all 18 hazards (wildfire, earthquake, hurricane, riverine & coastal flooding, tornado, heat/cold wave, drought, …). Free, public-domain. For siting, insurance, and resilience planning; complements geo.flood-zone (flood SFHA only).
gov.fcc-idResolve an FCC ID (printed on US wireless/electronic devices) to the grantee — the manufacturer holding the FCC equipment authorization. Pass fccId in any form (BCG-E3217A, BCGE3217A). Returns grantee code, product code, and the grantee company (name, city, state, country, registration date). FCC EAS open dataset, free and keyless — the "who made this device" lookup an agent reading a hardware label cannot do natively. (Per-product RF detail like frequencies/equipment class is not in the open dataset.)
gov.nfip-claimsFEMA National Flood Insurance Program (NFIP) claims history for a US location — the flood losses actually paid out in an area. Requires state (2-letter); narrow by county (5-digit FIPS), ZIP, and yearOfLoss range. Returns the total matching claim count plus recent redacted claims (date of loss, county/census tract/ZIP, rated flood zone, cause, water depth, net building + contents payment USD, approx lat/lon), largest net payout first. FEMA redacts city, so filter by county/ZIP. Free, public-domain (OpenFEMA). Distinct from geo.flood-zone (current SFHA) and gov.risk-index (modeled future risk) — this is the realized loss track record, for underwriting + property diligence.
gov.hazard-mitigationFEMA Hazard Mitigation Assistance (HMA) funded projects — the pre- and post-disaster mitigation grants FEMA has actually obligated (HMGP, BRIC/PDM, FMA). Filter by state (2-letter), disasterNumber, programFy (fiscal year), and/or programArea; at least one filter required. Returns total matching project count + projects (identifier, program area, project type, status, recipient/subrecipient, county, project amount + federal share obligated USD, cost-share %, benefit-cost ratio, number of properties, approval/close dates), largest federal share first. Free, public-domain (OpenFEMA). Distinct from gov.public-assistance (recovery grants) and gov.nfip-claims (flood losses) — this is mitigation funding to reduce future risk.
gov.public-assistanceFEMA Public Assistance (PA) funded project details — the post-disaster grants FEMA obligates to state/local/tribal governments and eligible nonprofits to repair public infrastructure and cover emergency response (debris removal, roads, buildings, utilities). Filter by state (2-letter) and/or disasterNumber (one required); optionally refine by incidentType. Returns total matching worksheet count + projects (disaster number, declaration date, incident type, project worksheet number, applicant, damage category, project size, status, county, federal share obligated / total obligated / project amount USD, obligation date), largest federal share first. Free, public-domain (OpenFEMA). Distinct from gov.hazard-mitigation (future-risk grants) and gov.nfip-claims (flood losses) — disaster recovery funding for public infrastructure.
gov.fecUS federal campaign finance from the FEC (openFEC). Two modes: pass name to search candidates (returns FEC candidate id, party, office, state, district, incumbent/challenger, status, election cycles); or pass candidateId (e.g. P80000722) to get that candidate's aggregate financial totals — receipts, disbursements, cash on hand, and individual / PAC / party / self contributions in USD (newest cycle), with identity. Free, public-domain (FEC). Search by name first, then pass a returned candidateId back in for the money.
gov.usajobsSearch open US federal government job postings from the official USAJOBS API. Filter by keyword (title/skills), location (e.g. "Austin, Texas" or a state), and/or hiring organization; at least one required. Returns total matching count + current openings with title, agency and department, location(s), salary range (USD) and pay interval, GS pay grade, work schedule, posting/close dates, and the official apply link. Public-domain (OPM). Live federal hiring data an LLM cannot recall.
gov.uk-crimeUK street-level crime around a lat/lng (+optional month YYYY-MM, defaults latest, data lags ~2mo) from Home Office data.police.uk. Returns total count, by-category breakdown, and recent records (category, street, lat/lon, outcome). Free, Open Government Licence. Location-risk signal for property/insurance/safety agents.
gov.bea-gdpQuarterly real GDP by US state from the Bureau of Economic Analysis (BEA) Regional accounts — all-industry total, in millions of chained (inflation-adjusted) dollars. Requires state (2-letter); optional year (defaults to last 5 years). Returns the state name + GDP observations (period like 2025Q2, real GDP millions USD, unit), newest quarter first. Free, public-domain (BEA). Authoritative state economic-output data an LLM cannot recall.
gov.eu-tendersSearch EU public-procurement notices from TED (Tenders Electronic Daily). Filter by country (ISO 3-letter buyer country e.g. DEU/FRA), cpv (Common Procurement Vocabulary code, e.g. 72000000 IT services), and/or keyword (full-text); or pass a raw TED expert `query`. Each result: publication number, English title, buyer + country, dates, deadline, CPV codes, notice/procedure type, value, notice + PDF links. Free reusable EU open data — live procurement intel for bid discovery + supplier monitoring.
gov.disaster-declarationsFEMA federal disaster & emergency declarations — every federally declared disaster since 1953, including ones declared this week. Filter by state (2-letter), disasterNumber, declarationType (DR=major disaster, EM=emergency, FM/FS/FW=fire management), incidentType (Hurricane, Fire, Flood, Severe Storm, …), county (5-digit FIPS), fiscal year (fyDeclared), and declaration date range (fromDate/toDate, YYYY-MM-DD). No filter → most recent declarations nationwide. Returns total matching count + records (one per designated county/area) with declaration string, disaster number, title, incident type, declaration/incident/closeout dates, designated area, county FIPS, FEMA region, and authorized assistance programs (Individuals & Households, Individual Assistance, Public Assistance, Hazard Mitigation). Free, public-domain (OpenFEMA). Distinct from gov.risk-index (modeled future risk) and gov.nfip-claims (realized flood losses) — the official federal-response record, for disaster logistics, eligibility checks, insurance, emergency management.
gov.disaster-assistanceFEMA disaster assistance dollars — how much federal aid was approved or obligated for a declared disaster, by place. program=individuals (default) returns Individuals & Households Program (IHP) approved housing assistance, one record per ZIP per disaster, with FEMA-approved repair/replace, rental, and other-needs dollars and valid-registration counts (tenancy=owner default, or renter). program=public returns Public Assistance funded-project summaries, one record per applicant (state/local government, tribe, or eligible nonprofit) per disaster, with the federally obligated grant amount and project count. Filter by disasterNumber (the join key to gov.disaster-declarations), state (2-letter), and zipCode (5-digit, IHP only); ordered by approved/obligated dollars (highest first) with the total matching count + a normalized approvedAmountUSD per record. Free, public-domain (OpenFEMA). Distinct from gov.disaster-declarations (what was declared/authorized), gov.risk-index (modeled risk), gov.nfip-claims (flood-insurance losses) — the realized federal-spend record.
gov.carrier-safetyFMCSA motor-carrier (trucking/bus) safety profile. Pass dot (USDOT number) for the full record: legal/DBA name, state, interstate/intrastate, operating-authority status (allowedToOperate), FMCSA safety rating, fleet size, crash history (total/fatal/injury/tow-away), roadside-inspection history with driver+vehicle out-of-service rates, and CSA BASIC measures (Unsafe Driving, Hours-of-Service, Driver Fitness, Controlled Substances, Vehicle Maintenance, Hazmat, Crash Indicator). Or pass name to search → matching carriers + DOT numbers. Free, public-domain US DOT data. For commercial-auto/freight underwriting, broker/shipper vetting, vendor diligence.
gov.representativesYour sitting US Congress members for a location. Pass a US address (geocoded to its state + congressional district) or an explicit state (2-letter) + optional district. Returns the current US House representative + the state's two US senators, each with name, party, state/district, Bioguide ID, DC office, phone, official website, and contact form. State-only → just the two senators; DC/territories → their non-voting delegate. Bundled CC0 data (unitedstates/congress-legislators). Fills the gap after gov.district (which gives the district, not the people) — civic lookup, advocacy, constituent tooling.
timezone.lookupResolve a coordinate to its IANA timezone, current UTC offset, local wall time, DST status, and short abbreviation. Polygon lookup against a CC0 timezone boundary index + runtime tzdata for current transition rules.
sunrise.computeAstronomically compute sunrise, sunset, solar noon, and civil/nautical/astronomical twilights for a coord + date.
earth.nowComposite situational awareness for a coordinate: timezone, local time, sunrise/sunset, nearby quakes, current weather.
earth.eventsActive and historical global natural events via NASA EONET v3: wildfires, severe storms, volcanoes, floods, droughts, landslides, sea/lake ice, dust/haze, manmade incidents, water-color anomalies. Each event includes geo-located observation points and category. Filter by status, days-back, category, or bbox.
quakes.recentRecent earthquakes near a coordinate (USGS feed).
geocode.addressForward geocode a free-text address to a coordinate (LocationIQ, OSM/ODbL).
geocode.reverseReverse geocode a coordinate to a labeled address.
geo.ipIP geolocation: country, region, city, lat/lon, timezone, ASN.
geo.postalResolve a postal/ZIP code to place name(s), administrative divisions (state/province, county/district), and coordinates. Pass postalCode + 2-letter country (default US). International — major markets (US, GB, CA, DE, FR, AU, NL, ES, IT, CH, SE, MX). Normalize + enrich addresses or derive state/county for a ZIP.
ipinfo.bulkBulk geolocate up to 100 IPs in one call.
dns.lookupDNS records via public DNS-over-HTTPS resolvers.
domain.whoisRDAP / WHOIS for a domain. Returns registrar, creation/expiry, nameservers, status codes.
url.unfurlOpen Graph / Twitter Card metadata for a URL — title, description, image, site name.
url.cleanFetch a page and return its article content with clutter stripped (no nav, ads, footer, scripts). format: markdown (default), text, both (JSON), html (self-contained reader page), or pdf (typeset reading doc). html/pdf return raw bytes.
url.renderLike url.clean but renders the page in a real headless browser (JS executed) — for client-rendered / SPA pages where a raw fetch sees an empty shell. Same formats (markdown/text/both/html/pdf). Tier 2 (~10× url.clean). Use url.clean for server-rendered pages.
url.mapDiscover the URLs a page or sitemap points at in a single fetch — <loc> entries from an XML sitemap/sitemap-index, or <a href> links from an HTML page (auto-detected). Resolved-absolute, deduped, http(s)-only. Stateless, no JS, NOT a recursive crawler — re-call on a child sitemap/page to go deeper. limit 1-2000 (default 200); sameHostOnly keeps same-host links.
wikipedia.summaryWikipedia article summary with thumbnail URL.
papers.searchUnified academic paper search across arXiv + PubMed + Semantic Scholar.
papers.citationsCitation graph for a scholarly work via OpenAlex. Pass id as a DOI (10.xxxx/…, doi.org URL) or an OpenAlex work id (W…). Returns the work's total citation + reference counts and a paginated list of either the works that CITE it (view=citing, default) or the works it REFERENCES (view=referenced); each with DOI, title, year, venue, authors, and its own citation count. Fresh citation data lands after any training cutoff. Complements papers.search with graph traversal.
census.zipcodeUS Census ACS 5-year demographics for a ZIP/ZCTA — population, income, housing, education.
census.demographicsUS Census ACS 5-year demographics for a state or county. Give a state (2-letter or 2-digit FIPS), optionally a 3-digit county FIPS, and get population, median age, median household + per-capita income, poverty rate (computed), households, owner-occupancy rate (computed), median home value, and median gross rent. Free, public-domain (US Census). Complements census.zipcode (ZIP-level) with state/county geography.
hash.computeCompute one or more cryptographic hashes (sha256, sha512, md5, sha1, sha3, etc.) over an input.
poi.nearFind points of interest near a coordinate. Backed by OpenStreetMap (Overpass API). Returns name, OSM id, lat/lon, distance in meters, address, phone, website, hours, brand, cuisine. Nearest-first.
barcode.generateGenerate a barcode or QR code as an image. Format defaults to qr; supported: qr, code128, ean13. Returns raw image bytes (base64 in MCP transport).
countdown.gifRender an animated countdown GIF to a target ISO-8601 timestamp. Returns raw GIF bytes (base64 in MCP transport).
image.compressCompress an image (fetch by URL OR pass base64 inline). Returns compressed bytes (base64 in MCP transport). Provide exactly one of url | imageBase64.
phone.normalizeE.164-normalize and classify a phone number using libphonenumber. Returns format variants (E.164, international, national, RFC3966) plus type (mobile, fixed_line, voip, premium_rate, toll_free, etc.) and region.
text.redactDeterministically redact secrets from text before logging, storing, or sharing. Keyless pure compute — nothing is stored. Each credential is replaced in-place with a [redacted:<kind>] marker (surrounding text preserved) and you get per-kind counts. Detects PEM private keys, JWTs, AWS access-key ids, GitHub/Stripe/OpenAI/npm/Slack/Google tokens, HTTP Bearer tokens, scheme://user:password@host URLs, and generic api_key/secret/token/password assignments. Idempotent. Pairs with store.doc-put redact=true.
space.weatherCurrent NOAA space-weather snapshot: planetary Kp index, solar flux, geomagnetic storm scale, aurora viewing forecast.
vehicle.vin-decodeDecode a 17-character VIN via NHTSA vPIC. Returns make, model, model year, body class, engine, transmission, fuel type, manufacturer, plant info.
vehicle.recallsNHTSA vehicle recall lookup. Search by VIN (precise), or make/model/year, or NHTSA campaign ID. Returns recall ID, component, summary, consequence, remedy, dates.
vehicle.complaintsNHTSA consumer complaints by make/model/year. Returns incident date, component, summary, crash/injury/fatality flags.
vehicle.investigationsNHTSA open vehicle investigations, newest first. Chronological feed — filters (make/model/year) are not supported by upstream.
vehicle.safety-ratingsNHTSA NCAP 5-Star crash-test ratings by make/model/year. Returns one item per crash-tested body style with overall/front/side/rollover star ratings, rollover probability, crash-avoidance tech flags, and complaint/recall/investigation counts. Untested vehicles return an empty list.
vehicle.modelsList all models offered by a make in a given model year (vPIC).
vehicle.decode-wmiDecode a 3-character World Manufacturer Identifier (WMI), the first 3 chars of a VIN, to manufacturer.
vehicle.manufacturersPaginated list of all NHTSA-registered vehicle manufacturers (vPIC).
agent.knowledge-deltaWhat's happened in <topic> since <date>? Multi-source delta (regulations, court opinions, papers, House+Senate votes) deduplicated and ranked. Designed so an agent can spend one call to catch up since its LLM training cutoff.
chem.compoundLook up a chemical compound by cid, name, smiles, or inchikey. Returns canonical structural identifiers + physical properties from NIH PubChem.
license.medicalUS healthcare provider lookup (NPPES NPI Registry). Lookup by 10-digit NPI (precise) or firstName + lastName + state. Returns name, credentials, specialty taxonomies with state license numbers, addresses, phone, identifiers.
license.brokerFINRA BrokerCheck — registered US brokers / investment advisors. Search by free-text query (name + firm) or by CRD number. Returns CRD, name + aliases, scopes, disclosure flag, industry-start date, current + previous employments.
bank.lookupFDIC-insured US bank directory. Lookup by name (fuzzy), FDIC certificate, RSSD ID, or state. Returns name, web address, active flag, location, established + insured dates, charter, branch count, assets/deposits ($1000s).
health.open-paymentsCMS Open Payments — Sunshine Act payments from pharma/device manufacturers to US physicians or teaching hospitals (~10M records per year). Lookup by NPI, name, payer (manufacturer) name, or state. Returns recipient + payer + payment (amount, date, nature: consulting/food/travel/royalty) + associated product (drug/device + therapeutic area).
nonprofit.searchUS 501(c) nonprofit organization search via ProPublica Nonprofit Explorer (IRS Form 990 + BMF). Search by name, 9-digit EIN, state, NTEE category code (e.g. "B99"), or subsection code (3 = 501(c)(3)). Returns EIN, name, location, NTEE code, subsection code + human description.
health.hospital-lookupCMS Care Compare hospital lookup. Lookup by 6-digit CMS Facility ID, or fuzzy by name + city + state + hospital type with optional min star rating. Returns address, phone, type, ownership, emergency services, overall rating, per-measure-group counts.
worldbank.indicatorWorld Bank Open Data — fetch a time series of a specific indicator (e.g., NY.GDP.MKTP.CD = GDP current US$) for a country (ISO 2/3-letter code or "all"). Optional yearFrom/yearTo bracket. 1000+ indicators, 200+ countries.
book.searchOpen Library book metadata search. Lookup by free-text query (title + author), or by individual title / author / ISBN. Returns work key, title, authors, first publish year, edition count, cover image URL, ISBNs, publishers, languages, subjects, ebook access.
clinical.trial-searchSearch ClinicalTrials.gov — every registered US (+ many international) clinical study (~500k). Free-text query, or direct NCT ID. Optional filters: recruitment status, sponsor, phase, country.
clinical.study-detailFull ClinicalTrials.gov study record by NCT id — the deep detail beyond clinical.trial-search. Returns description, status, phases, conditions, design (allocation/model/purpose/masking), enrollment, interventions, primary + secondary outcome measures (with time frames), full eligibility criteria (text, sex, age range, healthy-volunteers), lead sponsor + collaborators, all facility locations, results-posted flag, and key dates. Free, public-domain (NIH NLM). Find an NCT id with clinical.trial-search, then use this.
paper.doi-lookupResolve a DOI to authoritative bibliographic metadata via Crossref. Returns work type, title, container (journal), publisher, dates, abstract, authors (ORCID + affiliations), pages, ISSN/ISBN, license, subjects, reference + citation counts.
code.repo-lookupLook up a public GitHub repository by "owner/name". Returns description, language, topics, license, counts (stars/forks/watchers/issues), timestamps, visibility, feature flags. Rate-limited to 60 req/hr/IP (unauthenticated).
wikidata.entityFetch a Wikidata entity (Q42, P31, etc.) — structured knowledge-graph record with labels + descriptions in selectable languages, claims (property → value), sitelinks. 110M+ entities, CC0.
registry.npm-lookupLook up an npm package by name (supports @scope/name). Returns description, repository, license, author + maintainers, keywords, distTags, latest version, and the 50 most recent versions with publish dates.
registry.pypi-lookupLook up a Python package on PyPI. Returns version, summary, project URLs, license, author/maintainer, classifiers, requires-python, runtime deps, recent release dates, yanked versions.
fx.ratesDaily reference exchange rates from the European Central Bank (via Frankfurter). 30+ major currencies. Optional base (default USD), symbols (target codes), date (YYYY-MM-DD; omit for latest), amount.
fx.timeseriesHistorical daily exchange-rate series from the European Central Bank (via Frankfurter) with computed stats. base (default USD), start (YYYY-MM-DD, required), optional end (default latest), symbols (comma-separated target codes), amount. Range capped at 366 days. Returns per-currency first/last/min/max/mean and absolute + % change, plus the full daily series. Business days only.
bls.seriesUS Bureau of Labor Statistics time-series data. seriesIds = comma-separated BLS series IDs (1-10 per call), optional startYear + endYear (max 10 years). Common: LNS14000000 (unemployment), CUUR0000SA0 (CPI-U), CES0000000001 (nonfarm employment).
country.lookupCountry metadata via REST Countries. Lookup by alpha2 (ISO 3166-1), alpha3, or name (with optional fullText exact match). Returns names, ISO codes, region/subregion, capital, population, area, languages, currencies, calling code, flag, coordinates, driving side, TLDs.
news.hn-topHacker News feed. kind = top | new | best | ask | show | job. Returns items with title, URL, score, comment count, author, time, dead/deleted flags.
news.hn-itemFetch a specific Hacker News item by numeric ID.
food.barcode-lookupFood product lookup by UPC/EAN barcode via Open Food Facts (CC0, >3M products). Returns product name, brand, ingredients, allergens, nutriments (per-100g + per-serving), Nutri-Score (a-e), NOVA processing classification (1-4), Eco-Score, categories, manufacturing origin, packaging, product image URLs.
food.hygiene-ukUK Food Standards Agency food hygiene ratings (FHRS). Search by business name and/or postcode; returns rating (0-5 or Scotland Pass/Improvement Required), rating date, component scores (hygiene/structural/management, lower=better), business type, local authority, address, geocode. Free, Open Government Licence.
word.defineEnglish dictionary entry via dictionaryapi.dev (Wiktionary, CC BY-SA). Returns IPA phonetic transcription(s), audio URLs, and meanings grouped by part of speech with definitions, examples, synonyms, antonyms.
word.relatedRelated-word lookup via Datamuse. Supply a seed word and relation kind: rhymes, near-rhymes, synonyms, antonyms, means (semantic match), triggers, homophones, sounds-like, spelled-like, follows-from, preceded-by. Returns ranked candidates with relevance score, syllable count, and grammar tags.
gov.congress-billUS Congressional bill lookup (congress + type + number) or filtered list via Library of Congress Congress.gov API. Bill types: hr (House), s (Senate), hjres/sjres (joint resolution), hconres/sconres (concurrent), hres/sres (simple).
Configuration
EVM_PRIVATE_KEYRequiredSecretHex-encoded EVM private key (0x-prefixed) used by the SDK to sign x402 EIP-3009 payment authorizations. Funds USDC on Base.
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachable2s-io/sdk is public and reachablegithub.com/2s-io/sdk ↗Pass
- Package names this repository as its source@2sio/mcp names 2s-io/sdk as sourcenpmjs.com/package/@2sio/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @2sio/mcpnpmjs.com/package/@2sio/mcp/v/1.82.0#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-24github.com/2s-io/sdk ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @2sio/mcpPass
- No critical advisory in the package or its dependencies224 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model300 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHub@2sio/mcp
MCP server for 2s.io — gives any MCP-aware agent 575+ pay-per-call tools: more ground-truth data than any other x402 API, a full AI gateway (chat, image, multi-model consensus), and agent infrastructure (storage, locks, queues, schedules, watchers).
upto billing (new on 2s): AI endpoints also accept the x402 upto scheme — authorize the quoted max, get settled for your actual usage (a real on-chain example settled at 1/42nd of the quote). Exact-scheme calls work unchanged.
Model Context Protocol is the standard for AI agents to discover and use tools. This package runs a local MCP server that exposes every 2s.io endpoint as a callable tool. Plug it into Claude Desktop, AgentKit, Cline, Continue, or any other MCP host.
npx @2sio/mcp --signer 0x...
No accounts to create. The server signs for whichever chain you configured a key on — Base USDC (EIP-3009) or Solana SPL-USDC. Settles in ~2 seconds. Prices start at $0.0025/call. 2s is an open-ended experiment in maximally-comprehensive agent infrastructure — the toolset grows continually (575+ endpoints across 113+ groups and counting).
Hosted (connect by URL, no install)
Prefer not to run anything? Point any MCP host at the hosted server:
https://2s.io/mcp
Streamable-HTTP transport; set header X-EVM-Private-Key: 0x… (an EVM key funded with USDC on Base) and the server signs + settles x402 per call. Security tradeoff: with the hosted server your private key transits 2s's infrastructure to sign — for keys that never leave your machine, run this package locally (above) or use the @2sio/sdk instead.
🔔 Watchers — push, not poll
Beyond read tools, 2s exposes watchers: the agent arms one and 2s POSTs a signed callback the moment something happens — a wallet moves, a stock crosses a price, a company reports earnings — so the agent never has to poll. Flat $0.05 to arm; signed + retried delivery with a status backstop. Tools: watchers.crypto-address-activity, watchers.stock-price, watchers.earnings (+ watchers.status / watchers.cancel).
What's exposed
A single MCP install gives the agent tools spanning, among others:
- Security — CVE lookup (NVD + CISA KEV + EPSS), email-security, HTTP security headers, password-exposure, RPKI, CT logs, IOC reputation, CWE / ATT&CK / CAPEC, exploit availability
- Patents & trademarks — USPTO patent search/detail/documents, trademark full-text search
- Legal & courts — federal & state case search and citation verification (CourtListener / Free Law Project)
- Financial filings & markets — SEC EDGAR filings, equities, FX, crypto, treasury rates
- Government & public records — Federal Register, Congress, FEC, BLS, US Census, nonprofits, licenses
- Science & medicine — arXiv / PubMed / Semantic Scholar papers, ICD-10, clinical trials, chemistry, nutrition
- Vehicles & aviation — NHTSA VIN decode & recalls, aircraft registry, flights, airports
- Energy, agriculture & maritime — energy prices & production, USDA agriculture, soil, vessel & port data
- Geospatial & weather — geocoding, NWS/NOAA forecasts, climate, earthquakes, tides, places, parks
- Business & property — company registries, GLEIF LEI, KYB, property records
- Web & data utilities — URL → markdown, screenshots, schema extraction, validators, EDI, hashing, barcodes, image description, AI summarization
- Agent primitives — memory, marketplace, knowledge-delta, batch settlement
- Control plane — wallet-scoped agent infrastructure: distributed locks/leases, durable message queues, scheduled cron callbacks, pub/sub topics with fan-out
- Storage — pay-per-call wallet-keyed persistence: key-value, documents, vector / full-text search, private blobs
- Watchers (push, not poll) — arm a signed callback for when a wallet moves, a stock crosses a price, or a company reports earnings
See the live catalog for everything currently shipped.
Try it free first
Pass --trial (or set TWOS_TRIAL=1) to make real calls without paying — one free call per endpoint per hour, no key required. Drop the flag and configure a key when you're ready to pay per call.
Claude Desktop setup
Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"2sio": {
"command": "npx",
"args": ["-y", "@2sio/mcp"],
"env": {
"EVM_PRIVATE_KEY": "0x...your_funded_base_mainnet_key..."
}
}
}
}
Restart Claude Desktop. The agent now has 575+ new tools — patent search, court-case lookup, SEC filings, VIN decode, ICD-10 lookup, sanctions screening, structured webpage extraction, secret/PII redaction, geocoding, weather, distributed locks/queues/schedules, wallet-keyed storage, multi-model consensus, ID crosswalks, and much more.
AgentKit / programmatic use
import { createTwoSioMcpServer } from '@2sio/mcp'
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'
const server = createTwoSioMcpServer({
privateKey: process.env.EVM_PRIVATE_KEY as `0x${string}`,
maxPriceUsd: 0.05,
})
await server.connect(new StdioServerTransport())
Safety
- There is no default price cap (
maxPriceUsddefaults toInfinity) — set--max-price(or themaxPriceUsdoption) to opt into a ceiling above which the server refuses to sign. - All payments use EIP-3009 single-use authorizations with a 60-second deadline. No spending allowances are issued; even if the key is compromised at rest, the attacker can only spend what's in the wallet at the moment of signing — and only at advertised prices.
- The key is read from env / argv into memory only; it never appears in any outgoing 2s.io request.
Tools exposed
Same set as @2sio/sdk. See https://2s.io/api/directory for the live catalog and https://2s.io/.well-known/x402 for the machine-readable manifest.
Links
- Site: https://2s.io
- Source: https://github.com/2s-io/sdk
- SDK:
@2sio/sdk - License: MIT
2s.io MCP questions
How do I add 2s.io MCP to Claude Code?
Run claude mcp add --env 'EVM_PRIVATE_KEY=<YOUR_EVM_PRIVATE_KEY>' mcp -- npx -y @2sio/mcp in your terminal. Add --scope user to make it available in every project.
How do I add 2s.io MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does 2s.io MCP provide?
It exposes 300 tools, including search.endpoints, batch.run, soil.profile, soil.hardiness-zone, agriculture.drought.
How do I run the 2s.io MCP server locally?
Run npx @2sio/mcp with a signer key, or configure it in your MCP host with EVM_PRIVATE_KEY set. No account creation is needed.
Do I need an API key or account to use 2s.io tools?
No account is required; the server signs x402 payments with a funded Base USDC or Solana USDC key. You can also try calls free with the trial flag.
Can I try 2s.io tools without paying?
Yes, pass --trial or set TWOS_TRIAL=1 to make real calls without paying, limited to one free call per endpoint per hour and no key required.
How much do 2s.io tool calls cost?
Prices start at $0.0025 per call and settle on-chain in about two seconds. AI endpoints also support upto billing so you pay for actual usage.
What are 2s.io watchers?
Watchers let an agent arm a signed callback that fires when an event happens, such as a wallet moving, a stock crossing a price, or an earnings report, so the agent doesn't poll. Arming costs a flat $0.05.