
research
io.astraeyelabs/research
AI research on U.S. stocks, ETFs and crypto: your reports, analyses, Earnings Radar and SAGE.
Documentation
AstraEye Labs MCP connector
AI research on U.S. stocks, ETFs and crypto, inside the assistant you already use.
AstraEye Labs is an AI research lab for U.S. stocks, ETFs and crypto. Specialist AI scientists compute figures in code from licensed market data, and SAGE, the research guide, writes one report from their findings, listing the data sources it used and what the data could not show.
This repository documents the AstraEye Labs remote MCP server. It lets an AI assistant (ChatGPT, Claude, Gemini, Perplexity, Grok or any MCP client) read a member's finished research reports and their methods, browse the analysis catalog and research templates, read the public research library, see the earnings calendar of the stocks they follow, follow a run and ask SAGE about their research. With the member's permission it can also change their watchlist, projects and Earnings Radar stocks, and price and start new research.
| Server URL | https://astraeyelabs.io/mcp |
| Transport | Streamable HTTP (stateless, JSON) |
| Sign-in | OAuth 2.1 with PKCE, to the member's own AstraEye Labs account |
| Official MCP Registry | io.astraeyelabs/research |
| Documentation | astraeyelabs.io/research-api |
| For AI assistants | astraeyelabs.io/llms.txt |
How the numbers are made
- Computed, not recalled. Figures in a report are computed in code from licensed market data and named public sources. The sentences around them are written by a model and can be wrong, so check anything important against the source the report names.
- Method and sources shown. Each report lists its data sources, and each analysis carries its method: what it measures, the rule it applies, and what it cannot support.
- Stocks, ETFs and crypto in one report, from desks for technical structure, fundamentals and macro, news and sentiment, on-chain and alternative data, derivatives, and discovery screens.
- Priced in credits. A run is priced in Astra Credits first, and never starts above the price the member agreed to.
Read published reports, no account needed: astraeyelabs.io/library
Guides: Seven checks before you trust an AI's stock or crypto numbers and Stocks, ETFs and crypto in one AI research report.
Connect it
Each connection is made from the assistant: you add the server URL, sign in to AstraEye Labs when it asks, and choose what the assistant may do. A connection is separate from a personal API token and can be disconnected on its own in AstraEye Labs settings.
- Claude: add a custom connector with the server URL
https://astraeyelabs.io/mcp. - ChatGPT: open Plugins, choose the plus button, name it AstraEye, and enter the server URL under Connection. Adding your own plugin can depend on your ChatGPT plan or workspace settings.
- Gemini (web): add AstraEye as a custom app and enter the server URL. Custom apps need a Google AI Pro or Ultra plan.
- Perplexity: open Connectors, choose Custom connector, then Add MCP connector, and enter the server URL. Then open the new connector and choose Add connector. Custom connectors need a Perplexity Pro plan or higher.
- Grok: open Connectors, add a custom connector and enter the server URL.
Who can connect. Any personal AstraEye Labs account (personal accounts only, 18+, not available in every
jurisdiction). On the free plan the connector serves the member's own reports, the public research library,
find_assets and Earnings Radar; every other tool answers that it is not available on the current plan. The full
set of tools needs the Space Analyst plan or above. New accounts start with a 7-day trial with no card. Current
plans: astraeyelabs.io/subscribe.
Use it
Once connected, ask the assistant in your own words. For example:
- "Show me my latest AstraEye report on NVDA and what its data sources were."
- "What does the AstraEye analysis Volatility Outlook measure, and what can it not support?"
- "List the newest reports in the AstraEye public library."
- "Turn on Earnings Radar for MSFT." (AstraEye then writes a report on each of MSFT's earnings releases.)
- "When do the stocks on my Earnings Radar report next?"
- "Create an AstraEye project on AAPL and BTC with a technical and a news analysis, and tell me the price before running it."
The assistant shows the price of a run in Astra Credits and starts it only after you agree. Research describes what the data shows; it never tells you what to buy or sell.
What it returns from a report. The written prose of the member's own reports: the executive summary, the discussion, the conclusion, the prepared questions and answers and, where a report has them, its methodology. It never returns a report's charts, tables or data fields; those stay in AstraEye Labs, and each report links to its page there.
Tools
Read tools (scope research:read):
| Tool | What it does |
|---|---|
list_research_projects | The member's own research projects, newest first |
list_research_reports | The member's finished reports, newest first, with each report's page |
get_research_report | The written summary of one finished report, with its disclosures |
get_report_methodology | How each analysis in a report works, in the run's own words |
list_analyses | The analyses AstraEye can run: scientist, asset class, what it does, the plan it is on |
get_analysis | One analysis in full, including its methodology and what it cannot support |
list_templates | Prebuilt research templates and the analyses each combines |
get_template | One template in full: the analyses it runs, in order |
get_research_project | One of the member's projects, as AstraEye will run it |
list_research_runs | The runs of one project, with status and whether results are ready |
get_research_run | One run's status and progress |
list_market_slices | Market slices a project can cover, such as the S&P 500, the Dow 30, a sector or the top 100 coins |
find_assets | Looks up crypto assets, U.S. stocks and ETFs by name or ticker and returns the id the other tools take |
list_watchlist | The assets on the member's watchlist. Research runs only on these |
list_public_reports | The public research library: reports anyone can read, newest first |
get_earnings_calendar | The next earnings report dates of the stocks the member follows, with the figures already computed on each |
SAGE and action tools (scope sage:chat, off by default and chosen on the consent screen):
| Tool | What it does |
|---|---|
ask_sage | Sends one question to the member's own SAGE chat and returns SAGE's answer. SAGE only answers here: it starts, prices and changes nothing. Each answer costs Astra Credits, within the daily credit limit the member set for this connection |
get_sage_messages | Reads the member's SAGE chat, including answers that finished later and notices that a run has completed |
add_to_watchlist | Adds assets to the member's watchlist |
remove_from_watchlist | Removes assets from the watchlist, and with them what the member recorded there |
create_research_project | Creates a project from analyses or a template. Nothing is priced, run or spent |
update_research_project | Changes a project's name, description, analyses, coverage or report options. Starts nothing |
archive_research_project | Archives a project |
restore_research_project | Brings an archived project back |
quote_research_run | Prices one run of a saved project, without starting it |
start_research_run | Starts a priced run after the member agreed to the price, spending credits within the daily credit limit. A run never starts above that price |
stop_research_run | Stops the run in progress. What it found so far is kept |
refresh_connected_balances | Refreshes balances from the exchanges the member connected. Free, and it never returns an amount |
turn_on_earnings_radar | Turns on Earnings Radar for one stock: a report on each of its earnings releases, within the member's plan |
turn_off_earnings_radar | Turns off Earnings Radar for one stock |
Safety and spending
- Sign-in is to the member's own account, with a consent screen and a step-up confirmation. Nothing is shared across accounts.
- By default a connection can only read. With the SAGE chat permission, every answer and every run spends Astra Credits only within the daily credit limit the member chose for that connection.
- Each tool that changes something is marked as an action, so assistants that ask before actions will ask the member first.
- One active connection per assistant. Disconnect it any time in AstraEye Labs settings.
About this repository
This repository holds documentation and the server's registry metadata (server.json) only. The server itself
runs at https://astraeyelabs.io/mcp; its source is not published here.
Support: support@astraeyelabs.io · astraeyelabs.io
AstraEye Labs provides AI-generated research for informational and educational purposes only. Research is impersonal and descriptive, and it is not investment advice. You decide what, if anything, to do. For users 18+; not available in every jurisdiction. AstraEye Labs LLC, Texas.
No installation packages available.