# Api Ninjas MCP server

Source: https://glimind.com/server/mcp-registry%2Fcom.api-ninjas%2Fmcp
Registry id: `mcp-registry/com.api-ninjas/mcp`
Status: live (checked 2026-10-27T01:26:00.351Z)

## Measurements (30 days)

- Uptime: 99.96%
- Checks: 3102
- Outages (90 days): 1

## Install

```json
{
  "mcpServers": {
    "api-ninjas-mcp-server": {
      "type": "http",
      "url": "https://mcp.api-ninjas.com/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http api-ninjas-mcp-server https://mcp.api-ninjas.com/mcp
```

## Tools (264)

- `Get_ZIP_Code_details`: Returns a list of ZIP Code details matching the input parameters.
- `Get_a_list_of_planets`: Get a list of planets matching specified parameters. Returns at most 30 results. To access more than 30 results, use the offset parameter to offset results in m
- `Get_a_list_of_stars`: Get a list of stars matching specified parameters. Returns at most 30 results. To access more than 30 results, use the offset parameter to offset results in mul
- `airportDistance`: Calculates great-circle distance, initial bearing, and estimated flight time between two airports. Requires `from` and `to`. Requires a premium subscription.
- `airportSuggest`: Returns autocomplete suggestions for airport search, matching IATA, ICAO, name, and city. Requires a `q` of at least 2 characters. Requires a premium subscripti
- `analyzeSentiment`: Analyzes the sentiment of a piece of text and returns a sentiment result for it. Requires `text` of at most 2000 characters.
- `binLookup`: Returns bank and issuer information for a Bank Identification Number. Requires a `bin`, typically the first 6-8 digits of a credit card number.
- `calculateCaloriesBurned`: Calculates calories burned from an activity, weight in pounds, and duration in minutes. Requires an activity. For valid names use /caloriesburnedactivities. The
- `calculateIncomeTax`: Calculates income tax for the United States or Canada from income, location, and filing status, including state or provincial tax. Requires `country`, `region`,
- `calculateMortgage`: Calculates monthly and annual mortgage payments and interest from a loan amount or home value and downpayment, plus optional HOA, tax and insurance. Requires `i
- `calculatePaycheckWithholding`: Premium only. Returns per-paycheck federal withholding, FICA (Social Security, Medicare, Additional Medicare), and optional state withholding given gross pay an
- `calculateSalesTax`: Calculates US sales tax on a purchase amount for a location given by ZIP code or by city and state, returning the tax breakdown and total. Requires `amount`.
- `checkDisposableEmail`: Checks whether an email address comes from a disposable or temporary email provider, for sign-up and fraud screening. Requires `email`.
- `checkLotteryTicket`: Premium only. Scores a ticket against a draw and returns the matched prize tier and prize. Supports Powerball (with Power Play and Double Play), Mega Millions (
- `classifyNaics`: Assigns one primary NAICS code to a business description by applying NAICS classification rules: the primary-activity test, cross-reference exclusions, and esta
- `closestAirport`: Returns the airports nearest a coordinate, sorted by airport size then by distance. Requires `lat` and `lon`. Requires a premium subscription.
- `computeTextSimilarity`: Returns a similarity score between 0 and 1 (1 is similar and 0 is dissimilar) of two given texts.
- `convertAirportCode`: Converts an airport code between IATA and ICAO. Pass exactly one of `iata`, `icao`, or `code` (auto-detected). Requires a premium subscription.
- `convertCurrency`: Converts an `amount` from one currency to another. Requires `have`, `want` and `amount`. For the raw rate without converting a figure use /exchangerate.
- `convertUnit`: Converts a numeric value from one unit of measurement to another. Requires `amount` and the source `unit`, with spaces written as underscores.
- `detectFaces`: Runs computer-vision face detection on an image supplied in the POST request body and returns the faces found. Takes no query parameters.
- `detectLanguage`: Detects which language a text is written in, across over 50 supported languages. Requires `text` of at most 1000 characters.
- `detectObjects`: Detects and labels the objects present in an image using a neural network. The image is sent in the body of the POST request.
- `encodeText`: Encodes any given text into a 768-dimensional vector using state-of-the-art NLP machine learning models.
- `extractTextFromImage`: Given an input image, return all detected texts and their bounding boxes.
- `filterProfanity`: Screens `text` for profanity and returns a censored version plus a flag indicating whether anything was found. Requires `text`.
- `findSwiftCodes`: Returns a list of bank information (including SWIFT/BIC Code) that match the input parameter. Returns at most 100 results. For more results, use the offset para
- `generateBarcode`: Generates a barcode image encoding `text`. Optional `type`, `format` and `include_text` control the symbology and output. Requires `text`.
- `generateLoremIpsum`: Returns one or more paragraphs of lorem ipsum placeholder text.
- `generatePassword`: Generates one random password of the requested length, optionally excluding numbers or special characters. Defaults to 16 characters when no length is given.
- `generateQRCode`: Generates a QR Code image for the specified data.
- `generateSudoku`: Generates a new Sudoku puzzle at a chosen box width, height, difficulty and optional seed for reproducible output. To solve an existing puzzle use /sudokusolve.
- `generateUserAgent`: Generates a user agent string, optionally matching a device `brand`, `model`, `os` and `browser`. To parse an existing user agent string instead use /v2/userage
- `getAdvice`: Returns one random piece of life advice, drawn from a set of over 5000 entries. Takes no parameters and returns a different result each call.
- `getAirQuality`: Returns the Air Quality Index plus CO, NO2, O3, SO2, PM2.5 and PM10 concentrations for a location. Requires a `city` or `lat`/`lon`; `state` and `country` disam
- `getAircraft`: Returns airplane specs matching the given filters, or decodes an ICAO (icao=A20N) or IATA (iata=32N) aircraft type code. At least one parameter other than limit
- `getAirlines`: Returns general and fleet information for airlines matching an ICAO code, IATA code, or name. At least one of `icao`, `iata`, or `name` must be set.
- `getAirports`: Returns airports matching filters such as IATA/ICAO code, name, city, country, region, elevation, size, or runway length. `name`, `city`, `region` and `q` are p
- `getAirportsList`: Returns a paginated list of airport codes and names. For filtered airport detail use /airports. Requires a premium subscription.
- `getAllCatNames`: Returns the names of every cat breed in the database and nothing else. Takes no parameters. For full breed detail and filtering use /cats.
- `getAllCountries`: Returns the 2-letter ISO codes of every supported country. For statistics about a specific country use /country. Requires a premium subscription.
- `getAllCountryFlags`: Returns flag image URLs for every supported country, territory and area. For one country's flag use /countryflag. Requires a premium subscription.
- `getAllDogs`: Returns the names of every dog breed in the database and no other fields. For breed traits and measurements such as height, weight, and shedding use /dogs.
- `getAllExercises`: Returns a comprehensive list of exercises that target a specific muscle group. Available on Business, Professional, or annual subscriptions only.
- `getAllStockExchanges`: Returns every supported stock exchange in one call. To look up one exchange by MIC, name, city, or country use /stockexchange. Business and Professional tiers o
- `getAnalytics`: Returns usage analytics and API call history for your own account, including which APIs you call most. Requires `api_key` as a query parameter. Calls here do no
- `getAnimals`: Returns scientific facts about animal species whose common name matches the search term, including partial matches. Requires `name`.
- `getBabyNames`: Returns baby names, optionally filtered by `gender` (boy, girl or neutral). By default only popular names, the top 10%, are returned; set popular_only to false 
- `getBalanceSheet`: Returns balance sheet data from SEC 10-Q and 10-K filings for one company, fiscal period and year. Requires `ticker` or `cik`. For which periods exist use /bala
- `getBalanceSheetAvailability`: Returns the fiscal years and quarters for which balance sheet data is available for a company. Requires a premium subscription (Developer tier and above).
- `getBankHolidays`: Returns bank holidays for a country and calendar year. Requires a `country`. To test a single date use /isbankholiday.
- `getBankInfo`: Returns the US bank identified by a routing number. Requires a 9-digit `routing_number`. To find routing numbers by bank name or location instead use /routingnu
- `getBiblePassage`: Returns Bible passages by reference, in one translation or up to five side by side, a random verse, or the verse of the day. A passage can be a single verse, a 
- `getBitcoinData`: Returns the latest Bitcoin price and market data. Takes no parameters. For a price series over a past time range use /bitcoinhistorical.
- `getBitcoinHistoricalData`: Returns historical Bitcoin price data over a chosen interval and Unix timestamp range. For the latest price instead use /bitcoin.
- `getBitcoinTreasury`: Bitcoin positions reported to the SEC in quarterly XBRL filings, covering operating companies and spot bitcoin exchange-traded products. Each position is as of 
- `getBsbInfo`: Looks up the bank, branch, address and supported payment systems for a 6-digit Australian BSB number. Requires `bsb`. To find a BSB by bank or location use /bsb
- `getBucketListItem`: Returns one randomly chosen bucket list idea. Takes no parameters, so call it again for a different suggestion.
- `getCanadaRoutingNumberInfo`: Returns the Canadian bank branch for a 9-digit EFT `routing_number`, or for a `transit_number` plus `institution_number`. To search by name or location use /can
- `getCarFacets`: Builds every dependent dropdown in one request instead of one request per level. Facets narrow with whatever is already selected. Available on every plan, inclu
- `getCarGenerations`: The level most vehicle APIs do not expose. Optional: nothing downstream requires it. Generations with no cars are returned with car_count 0 so gaps are visible.
- `getCarMakes`: Lists car manufacturers available in the catalogue. Use it to populate a make selector before calling /carmodels. Requires a paid plan (Premium).
- `getCarModels`: Lists the models belonging to a given manufacturer. Pair with /carmakes upstream and /cargenerations downstream. Requires a paid plan (Premium).
- `getCars`: The main endpoint. Search the whole catalogue by any combination of filters, or fetch cars you already know with id/ids. Every car is returned with its complete
- `getCashFlow`: Returns cash flow statement data from SEC 10-Q and 10-K filings for one company, fiscal period and year. Requires `ticker` or `cik`. For available periods use /
- `getCashFlowAvailability`: Returns the fiscal years and quarters for which cash flow data is available for a company. Requires a premium subscription (Developer tier and above).
- `getCats`: Returns cat breeds matching the given parameters, including weight, life expectancy, shedding, grooming and friendliness traits. For breed names only use /allca
- `getCelebrity`: Returns celebrity records with net worth, profession, and birthday, filtered by name, net worth range, nationality, or height in meters.
- `getChuckNorrisJoke`: Returns one random Chuck Norris joke. Takes no parameters. For jokes on other topics such as pop culture, science or history use /jokes.
- `getCityData`: Get city data from either a name or population range. Returns a list of cities that satisfies the parameters.
- `getCommodityContract`: Returns price information for a specific commodity contract or all contracts matching a commodity root. Either symbol or symbol_root must be provided, but not b
- `getCommodityContractList`: Returns a list of all available commodity contracts with their symbols and commodity names. This endpoint is useful for discovering which contracts are availabl
- `getCommodityForwardCurve`: Returns every active futures contract for the requested commodity, sorted by contract month, along with a contango/backwardation classification and 1-month and 
- `getCommoditySnapshot`: Returns an enriched price object for all 30 supported commodities on every plan, including the free tier. Free responses carry the last completed daily settleme
- `getCommoditySpotPrice`: Returns the spot price (the price for immediate delivery) for commodities that have a spot market: gold, silver, platinum, and palladium (composite: blended liv
- `getCounter`: Fetches a stored integer counter by `id`, optionally incrementing it with `hit` or setting it to a given `value`. Using a new id creates a new counter.
- `getCountryData`: Returns geographic, demographic, and economic statistics for countries matching filters such as name, currency, GDP, population, area, or unemployment rate.
- `getCountryFlag`: Returns URLs of one country's square and rectangle SVG flag images. Requires a 2-letter ISO-3166 alpha-2 `country` code. For URLs of all supported flags use /al
- `getCounty`: Returns details for one or more counties matching the input parameters.
- `getCovidData`: Returns Covid-19 case counts or deaths by country, administrative region, or US county, as a series or a single-day snapshot. Either `date` or `country` must be
- `getCryptoPrice`: Returns the current market price of a cryptocurrency. Requires a `symbol` such as BTCUSD or ETHBTC. Symbols ending in USD are priced in real US dollars; symbols
- `getCryptoPriceHistorical`: Returns historical OHLCV candles for a cryptocurrency at a chosen interval and time range. Requires a `symbol` such as BTCUSD or ETHBTC. Symbols ending in USD a
- `getCryptoSymbols`: Returns the list of cryptocurrency ticker symbols available. Use it to find valid symbols before requesting quotes from the Crypto Price API.
- `getCryptoTreasury`: Crypto asset positions reported to the SEC in quarterly XBRL filings. Coverage is limited to SEC filers (holders listed only outside the US are not included), a
- `getCurrencyVolatility`: Returns the latest realised volatility for a currency `pair`, with optional `window`, `method` and annualisation. For a time series use /currencyvolatilityhisto
- `getCurrencyVolatilityForecast`: Projects forward volatility for a currency `pair` over a `horizon`, using EWMA or a comparable `method`. For realised values instead use /currencyvolatility.
- `getCurrencyVolatilityHistorical`: Returns a realised volatility time series for a currency `pair` across a date range or `days` lookback. For the latest single value use /currencyvolatility.
- `getCurrentCommodityPrice`: Returns the current price for a single commodity (when `name` is provided) or a list of commodities (when `names` is provided). Optional `currency` and `unit` p
- `getCurrentGoldPrice`: Returns the current gold futures price in USD. Free responses carry the last completed daily settlement; premium plans return the live price.
- `getCurrentInflation`: Returns current monthly and annual inflation percentages. Premium subscribers only.
- `getCurrentInterestRates`: Returns the latest published value of a central bank or benchmark `rate`. For the full history of that rate use /historicalinterestrates.
- `getCurrentMetalsPrice`: Returns the current spot price of a metal with its futures price and contract. Free tier returns the last daily close for every metal; Developer plans get a spo
- `getCurrentOilPrice`: Returns the current price for a crude oil or energy benchmark. Free tier returns the daily closing price for WTI (type=wti) and Brent (type=brent); premium tier
- `getCurrentStockPrice`: Returns the current price of a stock or market index. Requires a `ticker` such as AAPL or ^DJI. For past prices and OHLC bars use /stockpricehistorical.
- `getCurrentWeather`: Get current weather, wind speed and direction, humidity, and temperature data by city, ZIP code, or geolocation coordinates (latitude/longitude). One of the fol
- `getDNSRecords`: Retrieves DNS records for a domain, covering the A, AAAA, CNAME, MX, NS, PTR, SRV, SOA, TXT and CAA record types. Requires `domain`.
- `getDadJoke`: Returns one or more random dad jokes. The `limit` parameter, which returns up to 100 jokes in a call, is available on premium plans only.
- `getDayInHistory`: Returns historical events that happened on a given `month` and `day`. Free requests cover today's date only; other dates plus `limit` and `offset` require premi
- `getDefinition`: Returns a string containing definitions for a given word.
- `getDogs`: Returns dog breeds matching filters such as name, height, weight, life expectancy, shedding, barking, energy, or trainability. For breed names only use /alldogs

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
