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.
Ask your agent in plain language. Each of these maps to a real tool on the server.
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
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
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 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
Retrieve random trivia questions with answers. Optionally filter by category such as science, history, geography, entertainment, sports, music, mathematics, and more.
lookup_ip
Get geolocation and network information for an IP address. Returns country, region, timezone, and validity status. Supports both IPv4 and IPv6 addresses.
get_nutrition
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
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
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
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 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
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 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 for exercises by name, type, target muscle, or difficulty level. Returns exercise details including instructions, equipment needed, and safety information.
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
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
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
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
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 an amount between two currencies using the provider exchange rate and return its timestamp.
search_countries
Find country statistics by name, ISO code, currency, or population range. Country populations are reported in thousands.
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 a five-day weather forecast in three-hour intervals by coordinates, city, or US ZIP code.
search_cities
Search cities by name, country, or population range and retrieve coordinates, population, and capital status.
get_holidays
Get holidays and observances for a country and year, with an optional holiday-type filter.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
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.
Common questions about connecting API Ninjas to AI agents with Metorial.