Ready APIs

135 MCP tools: geo, email, phone, company, DNS, FX, equities, weather, tax, econ, intel — one key.

CommunityOnlineAPI key requiredGlobalFreeRead-only

What it can do

    What data it sees

    Do you need an account

    An API key from the service settings is required

    135 MCP tools: geo, email, phone, company, DNS, FX, equities, weather, tax, econ, intel — one key.

    How to connect

    How to connect Ready APIs to Claude

    The server address to paste into Claude settings:

    https://readyapis.com/mcp

    1. Open Claude (claude.ai or the desktop app).
    2. Go to Settings → Connectors.
    3. Click Add custom connector.
    4. Paste the server address copied below into Remote MCP server URL and click Add.
    5. In a chat, click + → Connectors and switch the new connector on.

    Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

    Authorization

    After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

    How to connect Ready APIs to ChatGPT

    The server address to paste into ChatGPT settings:

    https://readyapis.com/mcp

    1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
    2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
    3. Open Settings → Connectors and click Create.
    4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
    5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
    6. In a new chat open + → Apps/Connectors and enable the connector.

    OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

    Authorization

    On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

    How to connect Ready APIs to Cursor

    The server address to paste into Cursor settings:

    https://readyapis.com/mcp

    Fastest: click Open in Cursor below and confirm the prompt.

    Manually:

    1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
    2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
    3. Save the file. The server appears in the MCP list; authorize it there if asked.

    Authorization

    If the service needs sign-in, an authorize button appears next to the server in the MCP list.

    Server tool list (135)

    Raw names from tools/list. Only developers need these.

    meta_catalogList public-safe dataset coverage, status, and endpoint counts. Demo mode is allowed.
    meta_datasetReturn public-safe coverage, limitations, and endpoint references for one dataset slug.
    geo_zip_lookupLook up a ZIP profile. Demo mode allows 30301, 30303, 10001, 94105, 60601, 78701, and 98101.
    geo_zip_batchLook up multiple ZIP profiles in one bounded request. Demo mode allows up to 5 selected sample ZIPs; production accepts up to 10.
    geo_enrichReturn the enriched ZIP profile shape used by production enrichment workflows. Demo mode allows selected sample ZIPs.
    geo_city_searchReturn ZIP profiles for a city and state. Demo mode allows selected sample cities.
    geo_county_lookupReturn ZIP profiles in a county by county FIPS. Demo mode allows selected sample FIPS values.
    geo_timezoneResolve a timezone using nearest ZIP centroid logic. Demo mode allows selected sample coordinates.
    geo_nearbyReturn distance-sorted ZIP profiles near a coordinate. Demo mode allows selected sample coordinates, radius up to 25 miles, and limit up to 10.
    geo_ipResolve an IPv4 or IPv6 address to city, state, country, coordinates, timezone, and the nearest US ZIP profile. Demo mode is limited to selected sample IPs.
    tax_federal_bracketsReturn federal tax bracket reference rows. Demo mode is limited to 2026 and standard filing statuses.
    tax_standard_deductionReturn standard deduction reference values. Demo mode is limited to 2026.
    tax_mileage_ratesReturn mileage-rate reference values. Demo mode is limited to 2026.
    tax_retirement_limitsReturn retirement contribution reference values. Demo mode is limited to 2026.
    tax_deadlinesReturn filing deadline reference values. Demo mode is limited to 2026.
    tax_state_bracketsReturn selected state individual income-tax bracket references. Demo mode is limited to Georgia 2026.
    tax_summaryReturn a combined federal bracket, standard deduction, mileage, retirement, and filing-deadline reference summary. Demo mode is limited to 2026.
    tax_calculateCompute progressive federal (and optional state) tax owed from gross income, filing status, year, and deductions. Returns tax, marginal/effective rate, take-home, and per-bracket impact. Demo mode is limited to 2026 and standard filing statuses. Reference data only, not advice.
    flight_reliabilityReturn historical route reliability. Demo mode allows selected loaded routes such as ATL-LGA, ORD-EWR, SFO-SEA, LAX-JFK, DFW-LAX, and ATL-MCO.
    flight_airport_delay_profileSummarize delay and reliability signals for an airport across loaded loaded route aggregates.
    flight_route_best_timesRank loaded departure-hour buckets for a route by historical reliability score.
    flight_airline_reliabilitySummarize loaded route reliability signals for a carrier code.
    flight_cancellation_riskReturn historical cancellation-risk signals for a route. This is not live tracking.
    flight_route_summaryReturn a combined historical route summary with reliability, cancellation risk, carriers, months, and best time bucket. This is not live tracking.
    company_domainReturn a company profile by domain. Demo mode allows selected sample domains.
    company_domains_batchReturn multiple company profiles by domain in one bounded request. Demo mode allows selected sample domains.
    company_searchSearch loaded curated company profiles by name, domain, industry, or ticker. Demo mode allows selected sample queries.
    company_industrySearch loaded curated company profiles by industry, category, or description signals.
    company_tickerReturn a loaded curated company profile by public ticker.
    company_nonprofit_einReturn a nonprofit identity profile by EIN.
    company_nonprofit_searchSearch nonprofit identity profiles by name, category, EIN, or state.
    company_classifyClassify a domain using the loaded curated company profile set.
    company_statsReturn aggregate counts across the 3.3M-entity registry — by country, jurisdiction, industry, entity_type, employee_range, decade founded, plus hierarchy/data-quality coverage. Filter the slice with country/jurisdiction/industry/naics.
    company_timelineChronological lifecycle event list for any company — founding year, SEC former-name rebrand events, current status, parent disclosures.
    company_networkWalk the GLEIF ultimate-parent hierarchy and return every entity sharing the same conglomerate root. Excludes pension/retirement trusts by default.
    company_registrationResolve a registry-assigned registration number (Companies House, Delaware file number, Handelsregisternummer, etc.) to a company profile. Pass country= to disambiguate since regnums aren't globally unique.
    company_changesVendor / counterparty change monitoring. Returns time-ordered entity changes (status flips, parent acquisitions, renames) filtered by since-date, LEI, change_type, or country. Critical for continuous KYC and M&A monitoring.
    company_lookup_autoAuto-detect identifier type and route. Accepts LEI, CIK, domain, email, ticker, or exact name. Returns resolution.matched_on so caller can confirm what type was used.
    company_insightsSingle-call mega-endpoint — subject profile + hierarchy + corporate-family network + lifecycle timeline + peer benchmark in one response. The 'everything we know' company call.
    company_cikResolve a SEC EDGAR Central Index Key (CIK) to a unified company profile. Accepts CIK with or without leading zeros (320193 = 0000320193 = Apple).
    company_peer_comparisonBenchmark a company against same-industry/same-country peers — employee distribution, jurisdiction mix, founding-decade histogram, and where the subject ranks within the peer set.
    company_lookup_batchResolve up to 50 mixed identifiers (domain, LEI, ticker, name) in a single POST. Each result preserves the original input for join-back.
    jobs_skill_trendsReturn job and skill-demand trend rows. Demo mode allows selected sample skills.
    jobs_related_skillsReturn ranked related skills for a loaded skill trend.
    jobs_role_skillsReturn aggregated skill signals for a role title. Demo mode allows selected sample job titles.
    jobs_remote_trendsReturn remote/hybrid/on-site trend buckets for a role title.
    jobs_companies_hiringReturn curated company-level hiring signals for a location and optional role family.
    jobs_salary_signalsReturn salary signal aggregates for a role title in the loaded trend set.
    email_validateValidate an email address: RFC syntax, MX lookup, disposable/free/role-account flags, typo correction, and a composite deliverability score. Demo mode is allowed; no live SMTP probe.
    email_disposableTest whether a domain belongs to the curated disposable-email-domain list.
    email_free_providerTest whether a domain belongs to the curated free consumer-email-provider list.
    email_smtp_probeLive SMTP RCPT probe (HELO + MAIL FROM + RCPT TO; no DATA). Reports deliverability verdict (deliverable / catch_all / undeliverable / greylisted / inconclusive). Catch-all detection via random-fake-RCPT comparison. Skipped automatically for Gmail / Outlook / Yahoo / iCloud / Fastmail / ProtonMail. ~3-8s latency.
    phone_validateValidate + enrich a phone number in 200+ countries. Returns E.164/national/international formatting, country, number-type (mobile/fixed/VoIP/toll-free/premium), carrier (where libphonenumber has data), timezones, disposable-carrier flag, and a risk band (low/moderate/elevated/high) for sign-up fraud screening.
    phone_regionLightweight country + region + primary timezone lookup for a phone number. Cheaper than phone_validate when you only need the country header.
    bin_lookupIdentify the issuing bank, scheme (Visa / Mastercard / Amex / etc), card type (credit/debit/prepaid), and country behind a card BIN. Accepts a 6-8 digit BIN or a full PAN (Luhn-checked, never echoed). Returns scheme + card_type + brand + issuer_bank + country + risk_band. PCI-safe.
    vin_decodeDecode a 17-character Vehicle Identification Number. Offline ISO 3779/3780 structural decode (syntax, check digit, country, model year) + NHTSA vPIC enrichment (make / model / trim / body / engine / plant). Use for insurance underwriting, used-car listing validation, fleet management.
    sanctions_searchSearch the US Treasury OFAC SDN list by name. 5-stage match cascade (exact primary, exact AKA, substring primary, substring AKA, fuzzy token-Jaccard) returns matches with programs (RUSSIA/IRAN/SDGT/etc), countries, AKAs, and 0.0-1.0 confidence. Filters by sdn_type / country / program. Decision support — not a substitute for full multi-list KYC.
    fx_ratesReturn current daily reference exchange rates relative to a base currency (default EUR), sourced from ECB.
    fx_convertConvert an amount between two currencies at the most recent reference rate.
    fx_historicalReference rate for a specific past date. Useful for 'what was USD→EUR on 2024-11-15?' questions.
    fx_timeseriesDaily rate series for a single base→quote pair across a date range. Useful for charts and trend analysis.
    fx_currenciesList every currency Ready APIs has reference-rate coverage for, with its issuing central bank and peg classification.
    fx_pairDeep enrichment for one currency pair: latest rate + 30/90-day volatility + trend + anomaly z-score + spread estimate + cross-strength + verdict. Decision-grade single-call summary.
    fx_strengthRanked strength leaderboard for the past N days. For each currency in the basket (g10 or majors), the average move across every pair it participates in. Strongest → weakest with per-currency label.
    fx_moversTop N pairs by absolute % change over the lookback window. Returns signed pct_change + direction (up/down/flat). Daily/weekly market briefing.
    fx_correlationPearson correlation of daily log-returns vs USD across a basket. Cells banded strong_positive/positive/neutral/negative/strong_negative. Treasury/risk workflow for understanding multi-currency exposure.
    fx_volatility_leadersPairs ranked by annualized realized volatility. Distinct from fx_movers — surfaces pairs that swing wildly day-to-day, even if flat overall. Classes: low/moderate/elevated/extreme.
    calendar_holidaysList US federal holidays for a year, including observed dates per OPM rules.
    calendar_is_business_dayCheck whether a US date is a business day (weekday and not a federal holiday).
    calendar_business_days_addAdd N business days to a date and return the resulting business day.
    geo_asnResolve an IP to its autonomous system number, organization, and network prefix.
    address_validateParse and validate a free-form US address: standardize street/unit/city/state/ZIP and cross-check the ZIP against the geo dataset for state and city consistency.
    dns_lookupResolve A, AAAA, MX, TXT, NS, CNAME, SOA, and CAA records for a domain.
    dns_whoisPublic WHOIS profile: registrar, creation date, expiration, name servers, age in years.
    dns_profileComplete DNS + WHOIS + security + hosting + email-infrastructure + subdomain-probe + health-verdict picture in one call. Sales-intel and security-audit workflow.
    dns_reputationComposite 0-100 reputation score combining domain age, registrar tier, expiration window, security grade, NS diversity, and hosting tier. Returns band (high/moderate/low/suspect) + contributing factors. Designed for fraud-screening pipelines.
    dns_certificatesRecent SSL certificates from Certificate Transparency logs (crt.sh). Returns recent certs with issuer + expiry, plus the deduped subdomain list discovered across all CT entries. Useful for shadow-IT detection, sales-intel hostname discovery, and phishing-cert monitoring.
    dns_tlsOpen a TLS handshake on :443, capture the presented cert + protocol version + cipher, and grade the result A-F. Surfaces days-until-expiry, SAN list, self-signed detection, and findings like 'CBC-mode cipher in use'.
    dns_compareCompare a target domain against a reference for phishing / typosquatting / lookalike detection. Computes edit distance, apex/TLD diff, homoglyph substitution detection (0↔o, 1↔l, rn↔m). Flags is_likely_typosquat + is_likely_lookalike with drivers. Pure analytical comparison — no DNS query.
    dns_historySnapshot-on-query passive-DNS view. Returns every (record_type, value) tuple seen for this domain during /dns/lookup calls, with first_seen + last_seen + observation_count. Useful for detecting when A records moved or recovering historical NS/MX values. Not a global feed — accumulates from when our users first resolve a domain.
    weather_currentCurrent conditions at a latitude/longitude in imperial or metric units. Sourced from Open-Meteo.
    weather_zipResolve a US ZIP to coordinates via the geo dataset, then return current weather.
    weather_forecastDaily forecast with travel-impact score (flight risk, outdoor event suitability) per day plus an overall precipitation outlook (dry/mixed/wet pattern).
    weather_alertsActive alerts from the US National Weather Service. Query by lat+lon, US ZIP, or two-letter state code.
    weather_compareRank up to 5 locations by comfort outlook (ideal > mild > poor > severe). Useful for trip planning, expansion site comparison, event location selection.
    weather_historicalLast 1-365 days of daily observations with pre-computed aggregates (frost-day count, summer-day count, rainy days, heavy-rain days, extremes). Answers 'is this a normal year?' questions.
    weather_normalsSame-window decadal climate normals for the next N days, plus a departure-from-normal block comparing the current forecast to the baseline. 'This week is 11°F above normal.'
    weather_degree_daysHDD and CDD over a window, with per-day rows. Used for HVAC sizing, utility bill reconciliation, energy forecasting. Default base 65°F is the NOAA HVAC standard.
    weather_best_windowFind the best contiguous N-day or N-hour window in the forecast horizon for an activity (outdoor_event, ski, construction, agriculture_spray, running). Returns top 5 windows ranked 0-100 with drivers.
    weather_hourlyHour-by-hour forecast: temperature, apparent temperature, precipitation probability + amount, humidity, cloud cover, wind speed/gusts/direction, and a WMO condition label per hour. For event timing, energy-demand curves, and logistics windows.
    weather_marineCoastal/marine hourly forecast: wave height, period, and direction, plus wind-wave and swell components. For shipping, fishing, surfing, and coastal-event planning. Coastal/open-water coordinates only — inland points return an error.
    weather_air_qualityCurrent air quality at a lat/lon or US ZIP: US EPA AQI + European AQI, plus pollutant concentrations (PM2.5, PM10, ozone, NO₂, SO₂, CO, dust) in µg/m³, a categorical band, and the primary pollutant. Source: Open-Meteo Air Quality (CAMS + EPA AirNow blend).
    weather_routeWeather conditions along a polyline route. Pass up to 20 legs, each a lat/lon waypoint with an optional ISO 8601 departs_at. Legs departing within 2 hours (or with no time) return current conditions; future legs return the daily forecast for that date. For trucking, road-trip, and delivery-window planning.
    equities_tickerResolve a stock ticker to company name, CIK, exchange, SIC industry code, and headquarters from the SEC EDGAR registry.
    equities_filingsLive SEC EDGAR submissions API: most recent filings (10-K, 10-Q, 8-K, ...) for a ticker or CIK. Filter by form type.
    equities_fundamentalsHeadline financial statements parsed from SEC XBRL filings: revenue, net income, total assets, EPS, cash flow, and 30 more curated tags. Annual (10-K) or quarterly (10-Q). Free — backed by SEC's public XBRL companyfacts API.
    equities_conceptFull observation history for one XBRL concept (any us-gaap tag). Use for fields outside our 35-item headline catalog. Returns every observation across every reported unit, most-recent first.
    location_scoreComposite hiring-location score (0-100) for a US ZIP, weighted by role profile (engineering, sales, operations, warehouse, retail, remote). Joins Census ACS demographics, FEMA flood, IECC climate, FAA airport, BEA cost-of-living, and state income tax into one tuned signal. Returns overall score, tier, verdict, and six sub-scores with notes.
    intel_role_profilesList supported role profiles for /intel/location-score and how each weights the six sub-scores (talent_pool, cost_pressure, tax_burden, connectivity, climate_resilience, quality_of_life).
    company_signalComposite B2B buyer-signal score (0-100) for a company. Joins curated identity + live SEC EDGAR filings + DNS/DMARC + WHOIS + curated hiring signals into one explainable score tuned by buyer profile (enterprise_sales, smb_sales, investor_research, vendor_diligence). Returns overall score, tier, verdict, six sub-scores with notes, tech-stack hint, and SEC activity summary.
    intel_buyer_profilesList supported buyer profiles for /intel/company-signal and how each weights the six sub-scores.
    counterparty_riskB2B counterparty-risk composite: should we extend terms to this company? Joins curated identity + live SEC EDGAR filings + DNS/DMARC + WHOIS into a risk-weighted 0-100 score (higher = lower risk), plus a tier and a decision_hint that maps to AR/AP actions (approve_net_30, approve_with_credit_check, require_prepayment, decline_pending_review). Supports four risk profiles for different underwriting postures.
    intel_risk_profilesList supported risk profiles for /intel/counterparty-risk and how each weights the six risk sub-scores.
    site_riskPhysical-location risk composite for a US ZIP. Joins FEMA flood + USGS seismic + NOAA tornado/hurricane + climate + EIA grid reliability into a 0-100 risk-weighted score (higher = lower risk). Tuned by site profile: insurance_underwriting, data_center_site, retail_storefront, warehouse_distribution. Returns underwriting_hint mapped to insurance actions.
    funding_signalSEC Form D-based funding-signal envelope. Pulls Form D / D-A filings live from EDGAR and surfaces a recency-weighted funding score, cadence hint (fresh_raise, recent_raise, established_cadence, stale), and buyer-shaped action_hint tuned by buyer profile (sales_outreach, vendor_partnerships, investor_research, recruiter). Form D filings are the public, free, authoritative record of private securities offerings.
    intel_funding_profilesList buyer profiles for /intel/funding-signal and their sub-score weights.
    company_changeSEC 8-K change-signal envelope for a public company. Pulls recent 8-K filings live from EDGAR, classifies item codes into change categories (M&A, leadership, restructuring, material agreement, financial, auditor, governance, disclosure), and returns a change-velocity score (0-100), dominant theme, and buyer-shaped action_hint tuned by buyer profile (sales_outreach, recruiter, investor_research, competitive_intel).
    intel_change_profilesList buyer profiles for /intel/company-change and their category multipliers.
    hiring_signalBuyer-shaped hiring velocity envelope. Pass `domain`/`company` for a company-keyed view, or `location` (+ optional `role`) for a market-keyed view. Returns velocity score (0-100), tier, growth verdict (rapid_growth, active_growth, ...), and a sales_hint mapped to typical actions for the chosen buyer profile (saas_sales, recruiter, investor_diligence, competitive_intel).
    intel_hiring_profilesList buyer profiles for /intel/hiring-signal and their weights.
    compliance_signalCompliance-status snapshot for a company: screens against Treasury OFAC SDN entries and SEC enforcement actions, and returns a 0-100 compliance score, tier, decision_hint (proceed / proceed_with_review / escalate / block_pending_review), and critical flags. Tuned by buyer profile (kyc_onboarding, vendor_diligence, regulated_industry, marketplace_listing). SCOPE: decision-support only — does not replace formal KYC or licensed sanctions screening.
    intel_compliance_profilesList buyer profiles for /intel/compliance-signal and their sub-score weights.
    cyber_riskDNS-hygiene + tech-stack-exposure surface for a domain. Returns a 0-100 cyber score (higher = lower risk) with six sub-scores (email security, DNS hardening, domain hygiene, infra exposure, tech-stack exposure, spoofability), critical flags, and concrete recommended actions. Tuned by buyer profile. SCOPE: inspects published DNS only — no port scans, breach lookups, or CVE matching.
    intel_cyber_profilesList buyer profiles for /intel/cyber-risk and their sub-score weights.
    tech_stackClassify a company's public tech footprint by inspecting MX / A / CNAME / NS / TXT records. Returns detections across categories (email_provider, hosting_provider, cdn_provider, dns_provider, SaaS tools via TXT) with vendor evidence on every detection. Non-intrusive — only looks at DNS the domain owner published.
    intel_site_profilesList supported site profiles for /intel/site-risk and how each weights the six physical-risk sub-scores.
    remote_hire_costComposite remote-hire envelope for a US ZIP + salary: total employer cost (salary + employer FICA + benefits load), employee take-home (federal + state + employee FICA), and the location-fit score under the 'remote' profile. Replaces a 20-40 minute back-and-forth with payroll on every remote candidate.
    address_enrichValidate a US address and return the full ZIP enrichment (demographics, risk, climate, nearest airport, hazards) in one call.
    address_validate_batchValidate up to 50 US addresses in one request. Per-item errors are returned inline.
    company_enrichOne-call company enrichment: identity + DNS + tech stack + SEC filings (if public) + cyber risk score.
    intel_rankScore and rank up to 100 ZIPs against a single site profile. Returns sorted by risk_score (highest = lowest risk).
    jobs_skill_trendsJob-count + trend direction + top related skills for a single skill (e.g. 'python', 'kubernetes'). Optional location filter.
    jobs_related_skillsTop related skills frequently co-mentioned with a target skill. Useful for skill-graph traversal and job-description templating.
    jobs_role_skillsSkills most commonly required for a given job title (e.g. 'staff engineer', 'product manager').
    jobs_remote_trendsRemote-work share by skill or title. Returns remote % alongside total job count and trend direction.
    jobs_companies_hiringTop companies hiring for a given skill or role. Returns company name + open-roles estimate + remote status + salary range when known.
    jobs_salary_signalsSalary range + midpoint + band tier (junior/mid/senior/staff) for a skill or title. Useful for comp benchmarking and job-posting copy.
    jobs_profileFull talent-market profile in one call: skill intel + role intel + market temperature + salary band + hiring velocity + location compete + talent verdict. Replaces ~5 separate calls.
    jobs_momentumRecent vs prior period demand for a skill. Returns score (-100..+100) and band (surging/rising/stable/cooling/falling) so you know if hiring for this skill is accelerating or decelerating.
    jobs_concentrationHHI-based geographic concentration for a skill. Returns hhi_score (0-100), band (diffuse → dominant), and top N metros with their job-count share. Answers 'where does the candidate pool live?'.
    jobs_scarcityEstimate candidates-per-open-role for a skill. Bands: severe_shortage / scarce / balanced / abundant. Workforce-planning signal for prioritizing hard-to-fill roles.
    jobs_skill_graphMulti-hop related-skill graph (BFS from seed). Returns nodes with hops_from_seed and edges with frequency-based weights. Use for broadening candidate filters, curriculum design, and job-description templating.
    fred_seriesFetch any FRED time-series by curated slug (gdp, cpi, unemployment, fed_funds, treasury_10y, vix, wti, mortgage_30y, ...) or raw FRED ID (CPIAUCSL, UNRATE, DGS10). ~800k series available — covers BLS, Census, Fed, Treasury, OECD, IMF, BIS. Free upstream, server-side key required.
    fred_searchFree-text search of FRED's ~800k series catalog. Ordered by popularity. Use when you don't know the series ID — e.g. q='initial jobless claims' surfaces ICSA + state-level variants.
    fred_popularList of curated FRED series shortcuts with their underlying FRED ID, title, units, and frequency. Use this catalog to discover what slugs are available for fred_series.