API Ninjas MCP server

Connect API Ninjas to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the API Ninjas MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get historical events tool in API Ninjas
  • Use the get weather tool in API Ninjas
  • Use the lookup domain tool in API Ninjas
  • Use the validate email or phone tool in API Ninjas
  • Use the get trivia tool in API Ninjas
  • Use the lookup ip address tool in API Ninjas

Supported Tools

get_historical_events

Get Historical Events

Search for historical events by keyword, date, or both. Find what happened on a specific day in history, or search for events related to a topic. Supports BC/BCE dates using negative year values.

get_weather

Get Weather

Retrieve current weather conditions for a location. You can specify the location by latitude/longitude coordinates, city name, or US zip code. Returns temperature, humidity, wind, and sunrise/sunset times. City and ZIP-code lookups require a premium plan.

lookup_domain

Lookup Domain

Get WHOIS registration data and DNS records for a domain, including registrar, creation date, expiration, and nameservers. Non-.com domains and some record types require a premium plan.

validate_contact

Validate Email or Phone

Validate an email address or phone number. Email checks include formatting, disposable domains, and domain DNS. Phone results include country, formatting, line type, and time zones when available.

get_trivia

Get Trivia

Retrieve random trivia questions with answers. Optionally filter by category such as science, history, geography, entertainment, sports, music, mathematics, and more.

lookup_ip

Lookup IP Address

Get geolocation and network information for an IP address. Returns country, region, timezone, and validity status. Supports both IPv4 and IPv6 addresses.

get_nutrition

Get Nutrition Info

Extract nutrition information from a natural language food description. Describe what you ate in plain English (e.g. "3 eggs and 2 slices of toast") and get detailed nutritional breakdown per item.

get_crypto_price

Get Crypto Price

Retrieve the current market price for a cryptocurrency trading pair. Provide a symbol pair like **BTCUSD**, **ETHUSD**, or **LTCBTC** to get the latest available price. Free plans update hourly; live prices require a premium plan.

get_quotes

Get Quotes

Retrieve inspirational, philosophical, or topical quotes. Filter by category (e.g. wisdom, success, love) or author. Great for content generation, daily inspiration, or finding quotes for a specific context.

get_stock_price

Get Stock Price

Retrieve the current price of a stock or market index. Provide a ticker symbol (e.g. **AAPL**, **GOOGL**) or index symbol (e.g. **^DJI**, **^GSPC**) to get its latest available price and trading volume. Free plans return the previous completed session; live prices require a premium plan.

analyze_sentiment

Analyze Sentiment

Analyze the sentiment of a text passage using AI. Returns a sentiment label (POSITIVE, NEGATIVE, NEUTRAL, WEAK_POSITIVE, WEAK_NEGATIVE) and a numerical score from -1 (most negative) to 1 (most positive).

lookup_word

Lookup Word

Look up a word's definition, synonyms, and antonyms. Combines dictionary and thesaurus data in a single lookup for comprehensive word information.

compare_text_similarity

Compare Text Similarity

Compare two text passages and get a similarity score using AI-powered NLP. Returns a score between 0 (completely different) and 1 (identical). Uses 768-dimensional vector embeddings and cosine similarity.

search_exercises

Search Exercises

Search for exercises by name, type, target muscle, or difficulty level. Returns exercise details including instructions, equipment needed, and safety information.

geocode_location

Geocode Location

Convert a city name or address into geographic coordinates (latitude/longitude), or convert coordinates back into a place name. Useful for mapping, distance calculations, and location-based lookups.

lookup_animal

Lookup Animal

Search for detailed information about animal species. Returns taxonomy, habitats, physical characteristics, diet, behavior, and conservation data. Supports partial name matching (e.g. "fox" matches "gray fox" and "red fox").

get_exchange_rate

Get Exchange Rate

Look up the current exchange rate between two currencies. Provide a currency pair (e.g. **USD_EUR**, **GBP_AUD**) to get the latest available conversion rate. Free plans update once daily; premium plans provide real-time rates.

get_commodity_price

Get Commodity Price

Retrieve the current price for a commodity such as gold, silver, platinum, natural gas, or other traded commodities. Returns the provider quote with its currency and unit, which may be US dollars or US cents. Free plans return the last completed daily settlement; premium plans provide live prices.

get_air_quality

Get Air Quality

Retrieve current air quality data for a location, including overall AQI and individual pollutant levels (CO, NO₂, O₃, SO₂, PM2.5, PM10). Specify location by coordinates or city name.

convert_currency

Convert Currency

Convert an amount between two currencies using the provider exchange rate and return its timestamp.

search_countries

Search Countries

Find country statistics by name, ISO code, currency, or population range. Country populations are reported in thousands.

get_world_time

Get World Time

Get the local date, time zone, UTC offset, and daylight-saving status for a timezone, city, or coordinates.

get_weather_forecast

Get Weather Forecast

Get a five-day weather forecast in three-hour intervals by coordinates, city, or US ZIP code.

search_cities

Search Cities

Search cities by name, country, or population range and retrieve coordinates, population, and capital status.

get_holidays

Get Holidays

Get holidays and observances for a country and year, with an optional holiday-type filter.

Connect API Ninjas to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable API Ninjas in Metorial. In your Metorial portal, enable the API Ninjas MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load API Ninjas tools.

Run API Ninjas through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give API Ninjas and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use API Ninjas tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with API Ninjas

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.

Technical notes for API Ninjas

Look up market prices and currency conversions, current weather and forecasts, air quality, places, local time, holidays, text analysis, nutrition, exercises, quotes, trivia, animal data, domain records, IP locations, and email or phone validation.

Frequently asked questions

Common questions about connecting API Ninjas to AI agents with Metorial.

  1. How many tools does the API Ninjas MCP server have?
    The API Ninjas MCP server exposes 25 tools, including Get Historical Events, Get Weather, Lookup Domain. Each one is governed and traced through Metorial.
  2. API Ninjas exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the API Ninjas MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use API Ninjas and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the API Ninjas MCP server yourself or use the hosted gateway.

Connect API Ninjas to production AI agents

See how Metorial gives your team governed access to API Ninjas, with tracing and security controls built in.