# Numbers API MCP > Numbers API provides instant factual data about dates, years, and integers. Your AI client can pull trivia, mathematical properties, and historical events for any number or day—all through natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** trivia, mathematics, historical-data, data-enrichment, educational-content ## Description Yo, check this out: This Numbers API hooks up your agent to a massive database of facts. It lets you pull trivia, math properties, and history for any date, year, or integer—all just by talking to it naturally. You ain't gotta search the web; your AI client hits this dedicated numerical encyclopedia instead. You wanna know what went down on October 24th? Ask for a specific month and day, and the server spits out all the significant historical milestones that happened then. Need some context about a whole year? Just give it the date, and **get_year_fact** aggregates major global or cultural events from that time. If you're dealing with numbers—and you always are—you got three ways to dig deep. You can use `get_math_fact` to get technical facts about how a number works mathematically; it calculates and reports stuff like prime status or sums. Then, if you just want fun knowledge for an integer, **get_trivia_fact** pulls obscure general trivia associated with that specific number. When you're feeling lost on what context you need but wanna keep the conversation going, `get_random_fact` delivers a totally unpredictable and interesting fact drawn from every category—history, math, or just plain old trivia. When talking about dates specifically, if you give it a month and day, **get_date_fact** returns historical events that occurred on that exact date. For instance, if you ask for the 7th of March, it’ll tell ya what happened historically on March 7th. If you've got some integer and need to know how its structure works mathematically, use `get_math_fact` to get **technical mathematical properties**. If that math ain't your thing, but you wanna hear a fun fact about the number itself—like why the number seven is weird or something—you call `get_trivia_fact`, and it gives ya **fun or obscure general knowledge**. Need to check out what big deals went down in 1929? You use `get_year_fact` to get a rundown of major global events for that entire year. If you're just vibing and need something quick, unpredictable, and totally random, just send the prompt to `get_random_fact`, and it hits ya with **a completely unpredictable fact** across all types of knowledge. It’s straightforward: Give it a number or a date, and your agent gets you the facts. You're set. No manual searching required for none of this. ## Tools ### get_date_fact Fetches a historical event fact for a given month and day (e.g., what happened on October 24th). ### get_math_fact Returns specific mathematical properties or facts about any provided integer. ### get_random_fact Delivers a fact drawn randomly from all categories (history, math, trivia) when no specific context is given. ### get_trivia_fact Retrieves fun or obscure general knowledge facts for any specified number. ### get_year_fact Looks up significant historical milestones and context associated with an entire year. ## Prompt Examples **Prompt:** ``` Tell me a trivia fact about the number 42. ``` **Response:** ``` Retrieving trivia for 42... According to Douglas Adams, it's the answer to the ultimate question of life, the universe, and everything. In reality, it's also the atomic number of molybdenum. ``` **Prompt:** ``` What happened on October 24th in history? ``` **Response:** ``` Fetching historical events for October 24th... On this day in 1945, the United Nations Charter came into effect. Would you like me to find facts for another significant date? ``` **Prompt:** ``` Give me a random math fact. ``` **Response:** ``` Retrieving a random mathematical property... Did you know that 1729 is the smallest number expressible as the sum of two cubes in two different ways? It's known as the Hardy-Ramanujan number. ``` ## Capabilities ### Retrieve historical events for a specific date You give the server a month and day, and it returns significant historical milestones that occurred on that exact date. ### Get mathematical properties of an integer The tool calculates and reports technical facts about how a specific number works mathematically (e.g., prime status, sums). ### Pull general trivia for any number It provides fun or obscure knowledge associated with an integer that isn't strictly mathematical. ### Get a random fact across all categories When you need context but don't know what to ask for, this tool delivers a completely unpredictable and interesting fact. ### Fetch historical facts about an entire year The server aggregates major global or cultural events that happened during the specified year. ## Use Cases ### Writing a time capsule article The writer needs to populate an article about the early 20th century. They ask their agent for facts on '1918.' The server uses `get_year_fact` and provides three major global events, letting the writer structure the content without leaving their chat window. ### Creating an educational quiz A teacher needs five random questions for a class on math history. They prompt the agent to generate facts using `get_trivia_fact` and `get_random_fact`, ensuring they get diverse, interesting numbers like 1729 without having to look them up themselves. ### Developing data visualizations A data analyst is working with a timeline that includes the date 'May 30th.' They use `get_date_fact` to pull the historical context for that specific day, allowing them to add a powerful narrative caption next to their purely numerical chart. ### Need filler content fast A marketer needs an obscure fact for a viral social media post. They prompt the agent with 'Give me something random.' The server uses `get_random_fact`, immediately providing high-quality, unexpected knowledge that makes their post shareable. ## Benefits - Need to back up a claim? Use `get_date_fact` to prove what happened on specific dates, instantly grounding your writing in verifiable history. It's better than skimming Wikipedia. - Stop searching for fun facts manually. Just ask your agent for a random fact and use `get_random_fact` to inject unexpected, high-quality trivia into any piece of content. - Struggling with dry data? Run the year through `get_year_fact`. Instead of just seeing '1945,' you get context about the UN Charter coming into effect. It's instant narrative building. - Forget simple definitions. Use `get_math_fact` to pull deep, technical mathematical insights for a number, giving your audience depth they won’t expect. - It cuts down on effort. Instead of juggling five different search queries (history, math, random, year, trivia), you route it all through one server using specialized tools. ## How It Works The bottom line is: you talk to your AI client like a human talking to an encyclopedia, and it handles the database lookups automatically. 1. Subscribe to the Numbers API server on Vinkius. 2. Your AI client recognizes your query requires factual data (date, number, or year). 3. The agent calls one of the specialized tools—for example, `get_math_fact(number=42)`—and returns the result directly into the conversation. ## Frequently Asked Questions **How do I use get_date_fact to find history?** You just provide the month and day. For example, 'What happened on October 24th?' The agent runs `get_date_fact` and returns historical events for that specific date. **Is get_trivia_fact different from get_random_fact?** Yes. Use `get_trivia_fact` when you know the number (e.g., '42') and need a fun fact about it. Use `get_random_fact` when you have no idea what kind of fact you want. **Which tool should I use for historical events?** Use `get_year_fact` if you want context for an entire year (e.g., 1945). Use `get_date_fact` if the specific day matters more than the whole year. **Can I use get_math_fact to check prime numbers?** Yes, that's its purpose. Simply ask for math facts about a number and `get_math_fact` will deliver properties like primality or factorization details. **Do I need an API key when calling `get_year_fact`?** No. This server uses a free public API, meaning you don't have to manage or input any keys or credentials. Your AI agent connects directly through Vinkius and executes the function call immediately. **What happens if I pass an invalid date range to `get_date_fact`?** It returns a structured error message detailing the specific issue with your input. The API validates dates before processing, so you'll get clear feedback instead of a crash or incorrect data. **Should I use `get_date_fact` or `get_year_fact` for historical context?** You should generally use `get_date_fact`. While `get_year_fact` gives general milestones, the date tool allows you to pinpoint the exact day and month of an event for much more precise records. **Is there a rate limit if I call `get_math_fact` many times in one session?** No explicit limits are documented. Since this is running on Vinkius's managed infrastructure, you can rely on standard usage patterns for repeated calls within your workflow. **Do I need an API key to use this server?** No, the Numbers API is completely free and does not require any authentication or API keys. **Can I search for facts about specific dates like my birthday?** Yes! Use the `get_date_fact` tool and provide the month and day. Your agent will return a historical event associated with that specific calendar day. **What kind of mathematical facts are available?** The `get_math_fact` tool provides properties like whether a number is a prime, Fibonacci number, perfect number, or has other unique mathematical characteristics.