SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Api ninjas MCP with Claude Code

Connect Claude Code to Api ninjas MCP. Get real-time bitcoin price and market data, check if this email is disposable, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Api ninjas logoApi ninjas
Api Key

Api ninjas offers 120+ public APIs spanning categories like weather, finance, sports, and more. Developers use it to supercharge apps with real-time data and actionable endpoints.

246 Tools

Introduction

Manage your Api ninjas directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns.

You can do this in two different ways:

  1. Via Composio Connect - Direct and easiest approach
  2. Via Composio SDK - Programmatic approach with more control

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Api ninjas with

Claude CoworkOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Why use Composio?

  • Only one MCP URL to connect multiple apps with Claude Code with zero auth hassles.
  • Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Handling Large tool responses out of LLM context to minimize context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need.

Connecting Api ninjas to Claude Code using Composio

1. Add the Composio MCP to Claude

Terminal

2. Start Claude Code

bash
claude

3. Open your MCP list

bash
/mcp

4. Select Composio and click on Authenticate

Select Composio and click Authenticate

5. This will redirect you to the Composio OAuth page. Complete the flow by authorizing Composio and you're all set.

Composio OAuth authorization page
Composio authorization complete
Ask Claude to connect to your account and authenticate via the link

What is the Api ninjas MCP server, and what's possible with it?

The API Ninjas MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your API Ninjas account. It provides structured and secure access to real-world data and utility tools, so your agent can analyze text, perform calculations, convert values, find location details, and retrieve financial information on your behalf.

  • Text analysis and cleanup: Have your agent analyze sentiment, detect languages, check spelling, filter profanity, compare text similarity, look up definitions, or generate text embeddings.
  • Financial calculations and market data: Let the agent calculate mortgages and sales tax, convert currencies, retrieve exchange rates, and look up earnings, mutual funds, GDP data, or insider transactions.
  • Location and travel research: Direct your agent to find cities, countries, airports, hospitals, EV charging stations, postal code details, or locations from coordinates.
  • Dates, holidays, and working days: Instruct your agent to retrieve public holidays or check whether a specific date is a holiday or working day in a country.
  • Everyday facts and practical lookups: Have your agent find recipes, exercises, aircraft details, air quality readings, domain availability, IP locations, MX records, or random facts.

Connecting Api ninjas via Composio SDK

Composio SDK is the underlying technology that powers these integrations. It provides a universal gateway with full programmatic control. You can programmatically generate an MCP URL with the app you need (here Api ninjas) for even more tool search precision. It's secure and reliable.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step10 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Claude Pro, Max, or API billing enabled Anthropic account
  • Composio API Key
  • A Api ninjas account
  • Basic knowledge of Python or TypeScript
2

Install Claude Code

bash
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

To install Claude Code, use one of the following methods based on your operating system:

3

Set up Claude Code

bash
cd your-project-folder
claude

Open a terminal, go to your project folder, and start Claude Code:

  • Claude Code will open in your terminal
  • Follow the prompts to sign in with your Anthropic account
  • Complete the authentication flow
  • Once authenticated, you can start using Claude Code
Claude Code initial setup showing sign-in prompt
Claude Code terminal after successful login
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here

Create a .env file in your project root with the following variables:

  • COMPOSIO_API_KEY authenticates with Composio (get it from Composio dashboard)
  • USER_ID identifies the user for session management (use any unique identifier)
5

Install Composio library

npm install @composio/core dotenv

Install the Composio TypeScript library to create MCP sessions.

  • @composio/core provides the core Composio functionality
  • dotenv loads environment variables from your .env file
6

Generate Composio MCP URL

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['api_ninjas'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http api_ninjas-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Create a script to generate a Composio MCP URL for Api ninjas. This URL will be used to connect Claude Code to Api ninjas.

What's happening
  • We import the Composio client and load environment variables
  • Create a Composio instance with your API key
  • Call create() to create a Tool Router session for Api ninjas
  • The returned mcp.url is the MCP server URL that Claude Code will use
  • The script prints this URL so you can copy it
7

Run the script and copy the MCP URL

node --loader ts-node/esm generate_mcp_url.ts
# or if using tsx
tsx generate_mcp_url.ts

Run your TypeScript script to generate the MCP URL.

  • The script connects to Composio and creates a Tool Router session
  • It prints the MCP URL and the exact command you need to run
  • Copy the entire claude mcp add command from the output
8

Add Api ninjas MCP to Claude Code

bash
claude mcp add --transport http api_ninjas-composio "YOUR_MCP_URL_HERE" --headers "X-API-Key:YOUR_COMPOSIO_API_KEY"

# Then restart Claude Code
exit
claude

In your terminal, add the MCP server using the command from the previous step. The command format is:

  • claude mcp add registers a new MCP server with Claude Code
  • --transport http specifies that this is an HTTP-based MCP server
  • The server name (api_ninjas-composio) is how you'll reference it
  • The URL points to your Composio Tool Router session
  • --headers includes your Composio API key for authentication

After running the command, close the current Claude Code session and start a new one for the changes to take effect.

9

Verify the installation

bash
claude mcp list

Check that your Api ninjas MCP server is properly configured.

  • This command lists all MCP servers registered with Claude Code
  • You should see your api_ninjas-composio entry in the list
  • This confirms that Claude Code can now access Api ninjas tools

If everything is wired up, you should see your api_ninjas-composio entry listed:

Claude Code MCP list showing the toolkit MCP server
10

Authenticate Api ninjas

The first time you try to use Api ninjas tools, you'll be prompted to authenticate.

  • Claude Code will detect that you need to authenticate with Api ninjas
  • It will show you an authentication link
  • Open the link in your browser (or copy/paste it)
  • Complete the Api ninjas authorization flow
  • Return to the terminal and start using Api ninjas through Claude Code

Once authenticated, you can ask Claude Code to perform Api ninjas operations in natural language. For example:

  • "Get real-time bitcoin price and market data"
  • "Check if this email is disposable"
  • "Look up bank info for this BIN"

Complete Code

Here's the complete code to get you started with Api ninjas and Claude Code:

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['api_ninjas'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http api_ninjas-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Conclusion

You've successfully integrated Api ninjas with Claude Code using Composio's MCP server. Now you can interact with Api ninjas directly from your terminal using natural language commands.

Key features of this setup:

  • Terminal-native experience without switching contexts
  • Natural language commands for Api ninjas operations
  • Secure authentication through Composio's managed MCP
  • Tool Router for dynamic tool discovery and execution

Next steps:

  • Try asking Claude Code to perform various Api ninjas operations
  • Add more toolkits to your Tool Router session for multi-app workflows
  • Integrate this setup into your development workflow for increased productivity

You can extend this by adding more toolkits, implementing custom workflows, or building automation scripts that leverage Claude Code's capabilities.

TOOLS

Supported Tools

Every Api ninjas action and event your agent gets out of the box.

Analyze Nutrition

Tool to extract nutrition information from text query.

Analyze Text Sentiment

Tool to analyze the sentiment of text.

Assess NAICS Risk

Assess documented compliance risk indicators for NAICS codes.

Calculate Airport Distance

Calculate great-circle distance, initial bearing, and estimated flight time between two airports.

Calculate Calories Burned

Tool to calculate calories burned for an activity based on duration and body weight.

Calculate Currency Volatility

Calculate realized volatility and percentile context for a currency pair.

Calculate Income Tax

Tool to calculate income taxes for US and Canada.

Calculate Mortgage

Tool to calculate mortgage payments and breakdowns.

Calculate Paycheck Withholding

Calculate federal, FICA, and optional state paycheck withholding.

Calculate Sales Tax

Tool to calculate sales tax for a purchase amount at a US location.

Check Bank Holiday

Check whether banks are closed on a date in a country or subdivision.

Check Disposable Email

Tool to check whether an email address is from a disposable email provider.

Check Domain Availability

Tool to check domain availability and retrieve registration information.

Check Holiday

Return all documented holiday categories on a date across every country when country is omitted; use Check Is Public Holiday for a country-specific public-holiday boolean or Check Bank Holiday for bank closures.

Check If Date Is Public Holiday

Tool to check if a specific date is a public holiday in a given country.

Check If Date Is Working Day

Check whether a date is a working day in a country, with configurable weekend days and optional inclusion of public holidays.

Check Lottery Ticket

Score a supported lottery ticket against a draw.

Check Sales Tax Nexus

Evaluate supplied sales and transaction totals against a state's economic-nexus rules.

Check Spelling

Tool to check spelling and get corrections for text.

Classify Business NAICS

Classify a business description to a NAICS code.

Compute Text Similarity

Tool to compute semantic similarity between two texts.

Convert Airport Code

Resolve an IATA, ICAO, GPS, ident, or local airport code to the matching airport record.

Convert Currency

Convert between currencies using current exchange rates.

Convert Unit

Convert between measurement units across different categories.

Detect Faces

Detect faces and return their pixel bounding boxes in a JPEG or PNG image.

Detect Objects

Detect labeled objects and bounding boxes in a JPEG or PNG image smaller than 2000 by 2000 pixels.

Detect Text Language

Tool to detect the language of input text.

Extract Text From Image

Extract text blocks and pixel bounding boxes from a JPEG or PNG image.

Extract Webpage Content

Retrieve URL information and webpage metadata, including domain, path, title, description, meta tags, and favicon.

Filter Profanity from Text

Tool to detect and censor profanity in text.

Find Closest Airport

Find airports near coordinates, with distance and optional size, runway, and IATA filters.

Find EV Charging Stations

Tool to find electric vehicle charging stations near a specified location.

Forecast Currency Volatility

Forecast currency-pair volatility across requested trading-day horizons.

Generate Barcode Image

Generate a barcode image for specified text in PNG or SVG format.

Generate Lorem Ipsum Text

Tool to generate Lorem Ipsum placeholder text.

Generate Secure Password

Tool to generate secure random passwords with configurable length and character types.

Generate QR Code

Tool to generate QR code images for encoding data.

Generate Random User Profiles

Tool to generate fake random user profiles with realistic data.

Generate Sudoku Puzzle

Tool to generate a new Sudoku puzzle with a specified difficulty level.

Generate Text Embeddings

Tool to encode text into vector embeddings using NLP models.

Generate Text Embeddings Batch

Generate embeddings for up to ten texts using a bounded sequence of calls to the provider's singular embeddings endpoint, returning per-item vectors or errors.

Generate User Agent String

Tool to generate realistic random user agent strings with optional filters for brand, model, OS, and browser.

Get Account Analytics

Return connected-account subscription and API usage analytics while redacting the API key.

Get Random Life Advice

Tool to get a random piece of life advice from the API Ninjas Advice endpoint.

Get Aircraft Information

Tool to retrieve aircraft information by manufacturer and model including specifications and performance data.

Get Airline Information

Tool to retrieve airline information by name, IATA code, or ICAO code.

Get Airport Information

Tool to search for airport information by IATA code, ICAO code, name, city, country, or region.

Get Air Quality Data

Tool to retrieve air quality index and pollutant data for a location.

Get Animal Information

Tool to retrieve detailed scientific information about animal species.

Get Baby Names

Tool to get baby name suggestions by gender.

Get Bitcoin Price and Market Data

Tool to retrieve the latest Bitcoin price and 24-hour market data.

Get Random Bucket List Idea

Tool to retrieve a random bucket list idea or activity.

Get Car Facets

Return grouped value counts for up to six caller-selected car dimensions; use LIST_CAR_MAKES, LIST_CAR_MODELS, or LIST_CAR_GENERATIONS for catalog listings.

Get Car Specifications

Query current car specifications by identity or documented filters.

Get Cat Breed Information

Tool to retrieve information on cat breeds matching specified parameters.

Get Celebrity Information

Tool to search for celebrity information by name or other criteria.

Get Chuck Norris Joke

Tool to retrieve a random Chuck Norris joke from the API Ninjas database.

Get City Information

Tool to retrieve city information by name, country, coordinates, or population filters.

Get Cocktail Recipes

Tool to search for cocktail recipes by name or ingredients.

Get Commodity Contract

Return one contract by exact symbol, or all matching contracts by root symbol.

Get Commodity Forward Curve

Return every active futures contract, sorted by month, for one commodity forward curve.

Get Commodity Market Snapshot

Return a current commodity market snapshot across supported contracts.

Get Commodity Price

Get real-time commodity prices from major exchanges (CME, NYMEX, COMEX).

Get Commodity Price History

Return historical commodity futures OHLCV prices without silently accepting a provider-truncated series.

Get Commodity Spot Price

Return one immediate-delivery spot price with name, or a batch array with comma-separated names (batch requires Business tier and above).

Get Company Logo

Retrieve a company logo URL by company name or ticker symbol.

Get Company Profile

Retrieve company profile information for a publicly traded company by stock ticker symbol.

Get Counter Value

Read the current value of a persistent counter scoped to the connected API key without incrementing or setting it.

Get Country Flag SVG

Tool to retrieve country flag images in SVG format.

Get Country Information

Tool to retrieve country information by name, ISO code, or economic and demographic filters.

Get County Information

Tool to retrieve US county information by name, ZIP code, or state.

Get COVID 19 Data

Return COVID-19 case or death statistics for a country or date.

Get Crypto Price

Get the current real-time price for a cryptocurrency trading pair.

Get Crypto Price History

Return historical cryptocurrency OHLCV prices for a symbol and interval.

Get Currency Volatility History

Return historical realized-volatility observations for a currency pair.

Get Random Dad Jokes

Tool to retrieve random dad jokes from API Ninjas.

Get Day in History Events

Tool to get historical events for a specific date.

Get Dictionary Definition

Tool to retrieve dictionary definition for an English word.

Get Dog Breed Information

Tool to get information on dog breeds matching specified parameters.

Get Earnings

Retrieve earnings filings by company or filing date, optionally filtering a company by fiscal period and year.

Get Earnings Calendar

Returns historical actual and estimated EPS and revenue by stock ticker, with an option for premium subscribers to include upcoming scheduled earnings dates.

Get Earnings Call Transcript

Retrieve the full earnings call transcript for a publicly traded company.

Get Electric Vehicle Info

Get electric vehicle information by make, model, year range, or electric range.

Get Emoji Information

Tool to retrieve emoji information and images from the API Ninjas Emoji database.

Get ETF Info

Retrieve ETF information by ticker, including its name, ISIN, CUSIP, and country.

Get EU VAT Rates

Retrieve current or historical EU VAT rates by country, with optional VAT type and effective-date filters.

Get Exchange Rate

Get the current exchange rate for a currency pair.

Get Exchange Rate History

Return historical exchange rates for a currency pair and date range.

Get Executive Compensation

Return disclosed executive compensation records for a public company.

Get Exercises

Tool to get exercise information by muscle group, type, or difficulty level.

Get Fact of the Day

Tool to retrieve the fact of the day from API Ninjas.

Get Random Facts

Tool to retrieve random interesting facts from API Ninjas.

Get Financial Statement

Retrieve one balance sheet, cash-flow statement, or income statement and its SEC filing metadata for a company and fiscal period.

Get GDP Data

Tool to get GDP data for a country.

Convert City to Coordinates

Tool to convert city names to geographic coordinates (forward geocoding).

Get Gold Price

Return the current COMEX gold futures price and contract month; use Get Gold Spot Price for immediate-delivery spot pricing.

Get Gold Price History

Return historical COMEX gold futures OHLCV observations.

Get Gold Spot Price

Return current immediate-delivery gold spot pricing, bid, and ask; use Get Gold Price for COMEX futures.

Get Helicopter Information

Tool to get helicopter information by manufacturer, model, and specifications.

Get Historical Events

Tool to retrieve historical events by date or keywords.

Get Historical Figures

Tool to search for historical figures by name.

Get Random Hobby Suggestions

Tool to get random hobby suggestions from API Ninjas.

Get Holidays

Retrieve the full 26-type holiday taxonomy for 2005-2039.

Get Daily Horoscope

Tool to get daily horoscope for a zodiac sign.

Get Hospital Information

Find hospitals by name, city, state, ZIP code or county.

Income Tax

Get federal and regional income-tax rates for a country and year.

Get Inflation Data

Tool to get current inflation data for a country.

Get Inflation History

Return historical CPI or HICP inflation observations for a country.

Get Insider Details

Return holdings and recent transactions for an exact insider name.

Get Insider Transactions

Tool to get insider trading transactions for publicly traded companies.

Get Institutional Ownership

Return institutional holders or the ownership summary for one security.

Get Interest Rate

Look up one current rate with rate (v2), or use legacy v1 aggregate mode with country or an empty request.

Get Interest Rate History

Return paginated historical observations for a named benchmark interest rate.

Get Joke of the Day

Tool to retrieve the joke of the day from API Ninjas.

Get Random Jokes

Tool to retrieve random jokes from API Ninjas.

Get Libor History

Return historical values for a documented LIBOR tenor.

Get Lottery Draw

Get one game's draw, or the latest draws for games in a state or country.

Get Lottery Draw History

Return one bounded page of historical lottery draws.

Get Market Cap

Tool to get real-time market cap data for a company.

Get Metals Prices

Return spot and matching futures data for precious metals plus copper and aluminum; unlike commodity spot tools, copper and aluminum use futures-based spot values identified by spot_type, and dedicated gold spot should be used for gold-only immediate-delivery requests.

Get Mortgage Rate

Get current or historical 15-year and 30-year mortgage rates.

Get Motor Carrier

Return a motor carrier record by USDOT or docket number.

Get Motor Carrier Insurance

Return active insurance filings for a motor carrier.

Get Motor Carrier Links

Return carriers linked through shared identifying attributes.

Get Motor Carrier Safety

Return crash, inspection, and BASIC safety data for a carrier.

Get Motorcycle Specifications

Tool to get detailed motorcycle specifications by make, model, and year.

Get Mutual Fund Info

Get mutual fund information by ticker or ISIN, including name, ISIN, CUSIP, and country.

Get MX Records

Tool to retrieve MX (Mail Exchange) records for a specified domain.

Get NAICS Code

Look up NAICS records by code, batch, or official title.

Get NAICS Size Standard

Return SBA size standards and optional eligibility calculations.

Get Nutrition Item

Return nutrition for one food item and quantity.

Get Oil Price

Return current futures-contract prices and contract metadata for oil and energy benchmarks; use Get Oil Spot Price for physical immediate-delivery prices.

Get Oil Price History

Return historical OHLCV data for an oil or energy benchmark.

Get Oil Spot Price

Return assessed physical spot pricing for oil and energy benchmarks.

Get Planet Information

Tool to retrieve detailed information about planets and exoplanets including mass, radius, orbital period, temperature, and host star data.

Get Population Data

Get historical and forecast population statistics for a country, including demographic and urban population metrics, or search countries by population range.

Get Postal Code Location Info

Tool to retrieve location information for Canadian postal codes.

Get Property Tax Rates

Tool to get property tax rates by city, county, or ZIP code.

Get Public Holidays

Tool to retrieve official public holidays for a specific country and year.

Get Quote of the Day

Tool to retrieve the quote of the day from API Ninjas.

Get Random Image

Tool to get a random image by category from API Ninjas.

Get Random Quotes

Tool to retrieve random quotes from API Ninjas.

Get Random Word

Tool to get a random English word from the API Ninjas Random Word endpoint.

Get Recipe

Search recipes by title, up to five ingredients, or nutrition filters.

Convert Coordinates to Location

Tool to convert geographic coordinates to location information (reverse geocoding).

Get Rhyming Words

Tool to get words that rhyme with a given word.

Get Random Riddles

Tool to retrieve random riddles with answers from API Ninjas.

Get Sales Tax Rates

Tool to get sales tax rates by ZIP code or city and state.

Get Sales Tax Filing Requirements

Return state sales-tax filing frequencies, thresholds, and due dates for a year.

Get SEC Filing

Tool to retrieve SEC filing information for publicly traded companies.

Get Short Interest

Return reported short-interest observations for a stock ticker.

Get Short Volume

Return daily short-sale volume observations for a stock ticker.

Get S&P 500 Constituents

Tool to retrieve current S&P 500 index constituents with filtering by ticker, name, sector, or date added.

Get Star Information

Retrieve star information including constellation, coordinates, magnitude, distance, and spectral classification.

Get Stock Exchange Information

Tool to retrieve stock exchange information by Market Identifier Code (MIC), name, city, or country.

Get Stock Exchange Hours

Return stock exchange session hours and open status for a date or timestamp.

Get Stock Price

Tool to get current stock price data for any publicly traded company or index.

Get Stock Price History

Return historical OHLCV stock-price points for a ticker and interval.

Get SWIFT Code

Tool to get bank information from SWIFT code or search by bank name, city, or country.

Get Thesaurus

Tool to get synonyms and antonyms for an English word.

Get Timezone Information

Tool to get timezone information for a location including UTC offset, local time, and timezone name.

Get Treasury Yield

Return the latest or dated Treasury par, real, bill, or combined yield curve.

Get Treasury Yield History

Return a paginated Treasury yield time series for one maturity or full curves by date.

Get Trivia Questions

Tool to retrieve trivia questions by category from API Ninjas.

Get Trivia of the Day

Tool to retrieve the trivia question of the day from API Ninjas.

Get Unemployment Rate

Tool to get unemployment rate data for countries.

Get University Information

Tool to retrieve university information by name or country.

Get Current Weather

Tool to retrieve current weather data for a location.

Get Weather Forecast

Tool to retrieve 5-day weather forecast in 3-hour intervals for a location.

Get WHOIS Information

Tool to get WHOIS domain registration information including registrar, creation date, and expiration date.

Get Working Days

Get working-day counts and dates for a country by year or month, accounting for weekends and public holidays.

Get World Time

Tool to get current date and time for a location with detailed date/time components.

Get US Zipcode Location Info

Tool to retrieve location information for US zip codes.

List Airports

List airport ICAO codes and names with offset pagination.

List Bank Holidays

List bank holidays for a country and year, including regional and observed dates.

List Breeds

List all cat or dog breed names accepted by the corresponding API Ninjas animal endpoint.

List Calorie Burning Activities

List activity names accepted by the Calories Burned calculator.

List Car Generations

List vehicle generations for a make and model, optionally limited to generations with cars.

List Car Makes

List vehicle makes, optionally filtered by search text or model year.

List Car Models

List vehicle models for a make, optionally filtered by search text or model year.

List Commodity Contracts

List all available commodity futures contracts and their symbols; this endpoint accepts no root filter.

List Company Insiders

List corporate insiders and current holdings for a public company.

List Countries

List 2-letter country codes accepted by the Country API.

List Country Flags

List country codes with square and rectangular SVG flag image URLs.

List Crypto Symbols

List cryptocurrency symbol pairs accepted by the Crypto Price API.

List Earnings Calendar Companies

List companies covered by the earnings calendar.

List Earnings Call Participants

List executives or analysts who appeared on a company's earnings calls.

List Earnings Transcripts

List companies with available earnings-call transcripts.

List Electric Vehicle Makes

List electric-vehicle makes available to the Electric Vehicle API.

List Electric Vehicle Models

List electric-vehicle models for a selected make.

List ETFs

List ETF ticker symbols available to the ETF API.

List Exercises

List exercise names for a target muscle group with offset pagination.

List Failures To Deliver

List the latest and historical SEC failures-to-deliver records for a security.

List Financial Statement Periods

List fiscal years and periods with an available balance sheet, cash-flow statement, or income statement for a company.

List Institutional Movers

List securities with the largest recent institutional ownership changes.

List IPO Calendar

List documented US IPO calendar records and filing details.

List Lottery Games

List documented lottery games and their rules.

List Lottery Jackpots

List current lottery jackpots using optional geography and currency filters.

List Motorcycle Makes

List motorcycle manufacturers accepted by the motorcycle API.

List Motorcycle Models

List motorcycle models for a manufacturer.

List Quote Authors

List quote authors available to the Quotes API with offset pagination.

List Sales Tax Holidays

Return US sales tax holiday periods, eligible categories, price caps, and coverage metadata.

List Short Interest Calendar

List short-interest settlement and publication dates for a calendar year.

List Stock Exchange Holidays

List market holidays and closure details for a stock exchange.

List Stock Exchanges

List all stock exchanges and their identity, location, market size, currency, timezone, and session details.

List Stock News

List dated news articles for one or more stock tickers with offset pagination.

List Stock Splits

List forward or reverse stock splits for a ticker or date range.

List Stock Tickers

Tool to retrieve a paginated list of all available stock ticker symbols and company names.

List Upcoming Earnings

List scheduled company earnings announcements by date or ticker.

List Weather Icons

List weather condition codes and their icon metadata.

Lookup BIN

Look up issuer, country, and payment-network details for a BIN.

Lookup BSB

Look up an Australian BSB and return its bank, branch, address, and payment-network details.

Lookup Canada Routing Number

Look up a Canadian routing number or transit and institution pair to return branch details.

Lookup DNS Records

Tool to retrieve DNS records for a specified domain.

Lookup IBAN

Tool to look up and validate an International Bank Account Number (IBAN).

Lookup India Pin Code

Look up Indian postal locations by PIN code, city, district, or state.

Lookup IP Address

Look up geolocation and ISP information for an IPv4 or IPv6 address.

Lookup Sort Code

Look up a UK sort code and return its bank, branch, address, and payment capabilities.

Lookup URL

Tool to get location information for a URL domain.

VIN Lookup

Tool to decode Vehicle Identification Number (VIN) and retrieve vehicle information.

Parse User Agent

Parse a user-agent string into browser, operating-system, and device details.

Scrape Website Content

Tool to scrape HTML content from a URL using the API Ninjas Webscraper endpoint.

Screen Sanctions

Screen a person or organization against supported sanctions lists and return candidate matches.

Screen Short Interest

Screen securities by exchange and short-interest metrics.

Search Branded Foods

Find branded food nutrition by barcode, product name, or brand.

Search Bsbs

Search Australian BSB branches by bank, suburb, state, or postcode.

Search Canada Routing Numbers

Search Canadian bank branches by institution, city, province, or postal code.

Search Crypto Treasuries

Search SEC-reported cryptocurrency holdings across supported digital assets.

Search Earnings Call Speakers

Search earnings-call speakers or retrieve one speaker's profile and appearance history.

Search Earnings Transcripts

Find available earnings-call transcript records by company or call date; this does not search transcript text.

Search ETFs

Search ETFs by fund name, AUM, expense ratio, holdings, or listing country; use Get ETF for an exact ticker.

Search Institutional Holdings

Search an institutional manager's holdings by manager CIK or exact manager name, with optional security and reporting-period filters.

Search Institutional Investors

Search the institutional-manager directory, filing history, or available quarters.

Search Motor Carriers

Search motor carriers using documented identity and location filters.

Search NAICS Codes

Search official NAICS text for relevant codes.

Search Routing Numbers

Search US routing numbers by bank name, location, ZIP code, or SWIFT code.

Search Sort Codes

Search UK bank branches by bank name, city, or postcode.

Search Tickers

Search public-company ticker symbols by company name and keyword exclusions.

Solve Sudoku Puzzle

Tool to solve a Sudoku puzzle using the API Ninjas Sudoku Solver.

Suggest Airports

Suggest compact airport matches for a name or code query, optionally filtered by country and size.

Update Counter

Increment or set persistent counter state scoped to the connected API key; use value=0 to reset a counter.

Validate Email

Validate an email address and check its deliverability.

Validate Phone Number Format

Validate phone-number formatting and return normalized national, international, and E.

Validate Phone Number

Validate and normalize a phone number and return country, carrier, line-type, VoIP, mobile-network, and disposable-number metadata.

Validate Routing Number

Tool to validate and retrieve bank information from a routing number.

Validate VAT Number

Validate a VAT number and return its registration and business details.

FRAMEWORKS

How to build Api ninjas MCP Agent with another framework

Claude Cowork logo

Claude Cowork

Use Api ninjas MCP with Claude Cowork

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Api ninjas MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Api ninjas MCP with Claude Agent SDK

Codex logo

Codex

Use Api ninjas MCP with Codex

OpenClaw logo

OpenClaw

Use Api ninjas MCP with OpenClaw

Hermes logo

Hermes

Use Api ninjas MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Api ninjas MCP with Atomic Agent

Google ADK logo

Google ADK

Use Api ninjas MCP with Google ADK

LangChain logo

LangChain

Use Api ninjas MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Api ninjas MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Api ninjas MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Api ninjas MCP with LlamaIndex

CrewAI logo

CrewAI

Use Api ninjas MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Api ninjas MCP with Pydantic AI

AutoGen logo

AutoGen

Use Api ninjas MCP with AutoGen

FAQ

Frequently asked questions

Start with Api ninjas.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Api ninjas tool your agent needs.Free to start.

Start building