# Spaceflight News MCP > Spaceflight News MCP Server gives your AI agent access to real-time data from major space agencies. You can use tools like `list_articles` and `list_reports` to pull thousands of technical reports, blog posts, and news articles programmatically. Stop bouncing between NASA, SpaceX, and ESA websites; get all the latest deep-space updates in one API call. ## Overview - **Category:** scientific-research - **Price:** Free - **Tags:** spaceflight, nasa, spacex, astronomy, satellite-launches ## Description You don't gotta hop between NASA’s site and ESA’s feed just for an update on deep-space missions anymore. This server gives your AI agent a single API endpoint to pull live, verified spaceflight data from multiple sources. It exposes specific tools that tell your agent exactly how to get the content you need—whether it's a technical paper or just some hot takes from the community. If you want to know if the whole thing is up and running before you start sending requests, use `get_info`. That checks the operational status of the **Spaceflight News API** server itself. For news coverage, your options are solid. If you need details on one specific article—say, the full write-up about a particular satellite launch—you run `get_article` and give it that unique ID; that pulls the entire text and all the associated metadata for just that piece. But what if you’re trying to cover a big event? You use `list_articles`. That tool searches through thousands of news articles, letting you filter results by specific **keywords**, date ranges, or even source agency across multiple providers. It's how you pull a comprehensive feed without logging in anywhere. When it comes to the community chatter—the good stuff—you got blog posts. If you want to see what the experts are talking about right now, use `list_blogs` to get a list of recent entries. Then, if one post catches your eye, run `get_blog` and supply its ID; that gives you the full content and metadata for just that single community discussion piece. For documentation—the heavy stuff—you're talking about reports. If you need official documents, like a detailed daily status update on the ISS or a mission analysis paper, you first list what’s available using `list_reports`. This gives you all the metadata for formal reports. Once your agent knows which report you want, it runs `get_report` and supplies that unique identifier to fetch the full **technical document**. Basically, this server handles three content types: standard news articles covering missions, specialized blog posts offering opinion pieces, and formal technical reports like daily status updates. You tell your agent what data type you need—articles, blogs, or reports—and it pulls everything from verified sources without you ever having to worry about the original source website. It's a single stream of space knowledge for your AI client. ## Tools ### get_article Retrieves the full text and details of one specific spaceflight news article by ID. ### list_articles Searches and lists multiple spaceflight news articles based on keywords, dates, or sources. ### list_blogs Lists recent blog posts, allowing you to see active discussions and opinion pieces in the field. ### get_blog Retrieves the full content of one specific blog post from a space community feed by its ID. ### get_report Retrieves a formal technical report or document by its unique identifier. ### get_info Checks the current operational status of the entire Spaceflight News API server. ### list_reports Lists available spaceflight reports, such as daily status updates for the ISS, along with their metadata. ## Prompt Examples **Prompt:** ``` Show me the 5 most recent spaceflight articles about the James Webb telescope. ``` **Response:** ``` I've found 5 recent articles using `list_articles`. They cover the latest deep-space images and calibration updates from the James Webb Space Telescope. Would you like the full details for any of them? ``` **Prompt:** ``` Get the latest technical reports from the ISS. ``` **Response:** ``` Fetching reports via `list_reports`... I've retrieved the latest International Space Station daily status reports. They include details on crew activities and station maintenance. ``` **Prompt:** ``` Search for blog posts from 'SpaceX' about Starship. ``` **Response:** ``` Searching blogs... Using `list_blogs` with the term 'Starship' and filtering for 'SpaceX', I found several updates regarding recent flight tests and orbital attempts. ``` ## Capabilities ### Find Specific News Articles Use `get_article` to retrieve the full content of a single spaceflight news piece using its unique ID. ### Search and List All Articles The `list_articles` tool searches through thousands of articles, letting you filter by keywords or dates across multiple sources. ### Access Single Blog Posts Call `get_blog` to pull the entire text and metadata for one specific blog entry from the community. ### List All Blogs The `list_blogs` tool lists recent blog posts, ideal for seeing what discussions are currently happening in the space community. ### Retrieve Formal Technical Reports Use `get_report` to fetch official documents, such as detailed ISS daily status updates or mission analyses. ### List All Reports The `list_reports` tool provides a list of formal reports, allowing you to quickly see available documentation and their metadata. ## Use Cases ### Tracking a Mission Failure Timeline A journalist needs to write about an engine failure. They ask their agent to run `list_articles` using the search term 'engine failure' and filter by date. Then, they use `get_report` to pull the official post-mortem technical report for background data, combining both sources in one draft. ### Comparing Agency Coverage A competitor needs to know what NASA, ESA, and private companies are talking about. They run `list_blogs` three times—once filtered by each agency name—to quickly compare the tone and focus of public discussion versus official news. ### Daily Operational Status Check An analyst needs to know if the ISS was active yesterday. Instead of visiting a dedicated status page, they run `list_reports` and filter for 'ISS daily' reports. The agent immediately pulls the latest document using `get_report`. ### Deep Dive Research on One Event A researcher is focused only on one specific topic, like the James Webb telescope. They use `list_articles` to get a list of all relevant pieces, identify an interesting ID, and then call `get_article` for the full text. ## Benefits - Stop manually checking five different space agency websites. Using `list_articles` lets your agent search thousands of articles across multiple sources at once, giving you a complete picture. - Get verified facts instantly. When you need the official word—like ISS maintenance details—call `get_report` or `list_reports`. It cuts out the guesswork and gives you structured data. - Differentiate content types easily. You can use `get_blog` for community opinion pieces, but switch to `get_article` when you need a hard news report on a launch failure. - Build historical context quickly. Instead of digging through archives, simply run `list_blogs` or `list_articles` and filter by date ranges to map out trends over years. - Check the API health before running big queries. Always use `get_info` first; it confirms if all news sources are currently active and tracking real-time data. ## How It Works The bottom line is, your AI client handles calling the specific tool (`list_reports`, `get_article`, etc.) needed to grab the exact space data you ask for. 1. Subscribe to the Spaceflight News server in your Vinkius Marketplace account. 2. Configure your AI client (Claude, Cursor, etc.) to use the MCP Server endpoint. 3. Ask your agent a question: 'List all articles about the James Webb telescope from last month.' The agent calls `list_articles` and returns the structured data. ## Frequently Asked Questions **How do I find all articles about a topic using list_articles?** You run `list_articles` and pass your search term (e.g., 'James Webb') into the appropriate filter parameter. The tool returns a structured list of matching news reports from multiple sources. **Can I use get_blog to find historical posts?** The `get_blog` tool is designed for specific, known IDs. If you need history, first run `list_blogs` and filter by date or keyword to find the correct post ID before calling `get_blog`. **What if I want to see both articles and blogs from one query?** You have to chain tools. Ask your agent to first run `list_articles` and then, separately, run `list_blogs`. The system needs two distinct calls to gather content from two separate data streams. **Do I need special credentials for get_info?** No. You just call `get_info`, and the server checks its own status, telling you if all news feeds are currently live or if there's an issue with tracking. **When I run multiple queries with `list_articles`, how does rate limiting work?** Your AI client should expect a specific HTTP 429 error when you hit the usage limit. The server returns details indicating how long to wait before retrying your request, so you can implement proper backoff logic. **If I pass an invalid or missing report ID to `get_report`, what should my agent expect?** The tool will return a 404 Not Found error. This means the specific spaceflight report doesn't exist in our database, so your agent must check the status code before trying to parse the data. **What is the difference between using `list_reports` and calling `get_info`?** `list_reports` returns a paginated list of available report summaries, giving you titles and dates. However, `get_info` only provides metadata about the API itself—it doesn't list any specific reports. **Does using `list_blogs` require me to specify date ranges?** No, you don't need a date range parameter. By default, it returns the most recent posts first, but you can filter results by adding an optional start and end date query. **How can I find news articles specifically about Mars or SpaceX?** You can use the `list_articles` tool and provide a keyword in the `search` parameter. For example, searching for 'Mars' will return all articles containing that term in the title or summary. **Can I filter news by a specific source like NASA or SpaceNews?** Yes! Use the `list_articles` or `list_blogs` tools with the `news_site` parameter to filter results from a specific provider. **How do I see which news sites are currently supported by the API?** Simply run the `get_info` tool. It returns metadata about the API, including a list of all news sites currently being tracked.