# ShowAPI MCP > ShowAPI / 易源数据 connects your AI agent to a massive API marketplace. Your agent can instantly get real-time stock data, check currency rates, translate text between languages, and retrieve weather forecasts—all from one prompt. It lets you automate complex tasks like content research or financial monitoring without writing any code. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** api-aggregation, data-marketplace, weather-data, translation, utility-apis ## Description You connect your AI agent straight into a massive marketplace of data APIs with **ShowAPI** (易源数据). This server takes complex API calls and turns them into simple prompts you give your agent. You don't write integration logic; you just ask the questions, and your agent handles all the messy work. ### Market Analysis & Finance If you need to check market data, you use `get_stock_info` to pull real-time performance numbers for specific stocks or entire indices. For global finance checks, you'll run `get_currency_rates` to get current foreign exchange rates between any pair of currencies. You can combine these; your agent knows how to check the stock movement while simultaneously telling you what the Euro rate is against the Yen. ### Location & Environmental Data Need to know where something is? Use `get_ip_lookup` to figure out the geographical data associated with any IP address. If you're tracking a location, run `get_weather` for current conditions and forecasts in a specific area. You can combine that geo-data knowledge with your agent's ability to check what day it is, allowing you to build complex reports about regional patterns. ### Language & Cultural Knowledge For anything involving language, the server handles it. Use `translate_text` to convert written material between two or more languages instantly. If you need a basic word definition, run `get_english_dictionary`. For Chinese context, there's `get_idiom_info`, which provides deep context and meaning for specific idioms. You can also get general knowledge by running `get_history_today` to retrieve major historical events that occurred on any specified date. ### Content Generation & Utility Tools When you need content material, the server has tools ready. For casual posts, your agent uses `get_jokes` to generate funny jokes or short stories. If you're writing something inspirational, you can fetch quotes using `get_inspirational_quotes`. You can also give your AI client a quick hit of local color by running `get_english_dictionary` for definitions and then pairing that with historical context from `get_history_today` to create educational posts. The whole system is built so when your agent gets the IP location from `get_ip_lookup`, it can automatically check the weather via `get_weather` for that exact spot, all in one go. ## Tools ### get_currency_rates Gets current foreign exchange rates between global currencies. ### get_english_dictionary Looks up definitions for English words. ### get_history_today Retrieves historical events that happened on a specified date. ### get_idiom_info Provides information and context regarding Chinese idioms. ### get_inspirational_quotes Fetches famous or inspirational quotes for content use. ### get_ip_lookup Looks up geographical data based on an IP address. ### get_jokes Generates funny jokes and short stories for casual content. ### get_stock_info Retrieves current market information for specified stocks or indices. ### get_weather Gets weather conditions and forecasts for a given geographic area. ### translate_text Translates text input from one language to another. ## Prompt Examples **Prompt:** ``` Translate 'Hello, how are you?' into Chinese using ShowAPI. ``` **Response:** ``` I've translated your text. 'Hello, how are you?' in Chinese is '你好，你好吗？'. Would you like me to translate it into any other language? ``` **Prompt:** ``` Show me the latest stock info for 'sh600000'. ``` **Response:** ``` I've retrieved the stock data for sh600000 (Shanghai Pudong Development Bank). The current price is ¥7.42, with a daily change of +0.54%. Would you like a more detailed breakdown of the technical indicators? ``` **Prompt:** ``` Tell me a random joke from ShowAPI. ``` **Response:** ``` Here's a joke for you: 'Why don't scientists trust atoms? Because they make up everything!'. Should I find another one or perhaps an inspirational quote? ``` ## Capabilities ### Check Market Rates Retrieve current foreign exchange rates using `get_currency_rates`. ### Analyze Stock Movements Get detailed, real-time stock market performance data via `get_stock_info`. ### Translate Text Convert written text between two or more languages using `translate_text`. ### Find Geo Data Determine the geographical location associated with any given IP address via `get_ip_lookup`. ### Get Local Weather Pull current and forecasted weather information for a specified area using `get_weather`. ### Research Historical Context Fetch major historical events that occurred on a specific past date using `get_history_today`. ## Use Cases ### Drafting a Global Blog Post A content creator needs to write about international business travel. Instead of opening Google, checking Wikipedia for historical facts (`get_history_today`), and then running a translator tool for foreign phrases, they just prompt: 'Write an intro on the history of trade in Rome, and translate the key phrase 'commerce' into Mandarin.' The agent runs `get_history_today` and `translate_text`, providing all necessary components immediately. ### Analyzing a Market Incident A financial analyst observes unusual stock volatility. They prompt their agent: 'Why did the S&P 500 drop today?' The agent runs `get_stock_info`, then uses that date to call `get_history_today` and perhaps checks global currency rates (`get_currency_rates`) to determine if a macroeconomic event was the cause. All data points are synthesized. ### On-the-Fly Field Reporting An ops manager is planning an overseas trip. They ask their agent: 'What's the weather in São Paulo next week, what are common local idioms there? And what’s the current exchange rate against USD?' The agent uses `get_weather`, `get_idiom_info`, and `get_currency_rates` to give a complete, actionable briefing. ### Debugging Client Location Issues A developer needs to validate where a user is connecting from. Instead of relying on browser headers, they ask the agent: 'What's the geographical data for this IP address?' The agent runs `get_ip_lookup`, giving precise metadata needed for conditional logic in their application. ## Benefits - **Consolidate Data Sources:** You don't need 10 different API keys or endpoints. ShowAPI bundles weather, finance, translation, and more into a single interface, letting your AI client call them all in one go. - **Rapid Content Drafting:** Combine multiple content tools—ask for jokes (`get_jokes`), then pull an inspirational quote (`get_inspirational_quotes`), and finally translate the result to Spanish (`translate_text`). It’s done in a single conversation turn. - **Cross-Domain Analysis:** Need to know if a stock market dip was related to geopolitical events? Your agent can check `get_stock_info` then follow up with `get_history_today`, building a cohesive narrative automatically. - **Operational Clarity:** Instead of opening three tabs (weather, map service, news feed), you ask: 'What's the weather in London and what are today's historical events there?' The agent handles both calls instantly. - **Code-Free Data Plumbing:** You eliminate boilerplate integration code. Your AI client speaks naturally to the tools; it's all handled by MCP. ## How It Works The bottom line is: your AI client acts as the conductor, calling multiple specialized tools in sequence so you don't have to manage them yourself. 1. Subscribe to the ShowAPI server and input your unique App ID and Secret. 2. Your AI client reads the 10 available tools, understanding what they do (e.g., `get_weather`, `get_currency_rates`). 3. You ask a single prompt that requires multiple data points; the agent figures out which tool to call first, runs it, and synthesizes the final answer for you. ## Frequently Asked Questions **How do I use get_stock_info with ShowAPI?** You simply tell your agent which stock ticker you want (e.g., 'Show me the latest stock info for AAPL'). The agent automatically calls `get_stock_info` and provides the current price, daily change, etc. **Can I translate text using ShowAPI's translate_text tool?** Yes. To use it, just prompt your agent with the source text and the target language: 'Translate this English sentence into Japanese.' The agent runs `translate_text` for you. **Do I need to know API keys when using get_weather?** No. You only need to provide your ShowAPI App ID and Secret once during setup. After that, the credentials manage themselves in the background while your agent calls `get_weather` for you. **What is get_ip_lookup used for?** It lets you find geographical data from an IP address. You can ask the agent: 'Where is this IP located?' and it runs `get_ip_lookup` to give you the city, country, etc. **If I give an incorrect location to `get_weather`, what error message should my AI client expect?** The tool returns a specific JSON error code indicating bad input. This lets your agent handle the failure gracefully instead of crashing the workflow. You'll need to check for geo-validation errors in your response logic. **Are there rate limits when calling `get_currency_rates` repeatedly?** Yes, the service enforces usage quotas based on your subscription tier. If you exceed them, your agent receives a standard 429 status code. You'll need to implement an exponential backoff strategy in your client logic. **When I use `get_idiom_info`, what structured data can I expect?** The tool provides a clean JSON object containing the idiom, its literal meaning, and multiple contextual usage examples. This structure helps your agent parse and present complex cultural information reliably to the end-user. **Do I need special permissions to combine tools like `get_jokes` and `translate_text`?** No, once you authenticate with your App ID and Secret, the server handles orchestration automatically. You simply write a natural language prompt asking for both tasks in one go. **How do I find my ShowAPI App ID and Secret?** Log in to the [ShowAPI](https://www.showapi.com/) website, go to your Personal Center -> [Secret Management], and you will find your `showapi_appid` and `showapi_sign` there. **Does this support all 1000+ APIs from ShowAPI?** This server provides 10 essential tools covering the most popular categories like weather, finance, and translation. For other specific APIs, you can extend the engine or use the marketplace directly. **Are there usage limits for these tools?** The usage limits and quotas depend on your ShowAPI subscription plan. Ensure your account has sufficient balance or points for the API points you are calling.