Repository avatar
AI Tools
v1.1.0
active

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.

AstraEye Labs MCP connector

Server URLhttps://astraeyelabs.io/mcp
TransportStreamable HTTP (stateless, JSON)
Sign-inOAuth 2.1 with PKCE, to the member's own AstraEye Labs account
Official MCP Registryio.astraeyelabs/research
Documentationastraeyelabs.io/research-api
For AI assistantsastraeyelabs.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):

ToolWhat it does
list_research_projectsThe member's own research projects, newest first
list_research_reportsThe member's finished reports, newest first, with each report's page
get_research_reportThe written summary of one finished report, with its disclosures
get_report_methodologyHow each analysis in a report works, in the run's own words
list_analysesThe analyses AstraEye can run: scientist, asset class, what it does, the plan it is on
get_analysisOne analysis in full, including its methodology and what it cannot support
list_templatesPrebuilt research templates and the analyses each combines
get_templateOne template in full: the analyses it runs, in order
get_research_projectOne of the member's projects, as AstraEye will run it
list_research_runsThe runs of one project, with status and whether results are ready
get_research_runOne run's status and progress
list_market_slicesMarket slices a project can cover, such as the S&P 500, the Dow 30, a sector or the top 100 coins
find_assetsLooks up crypto assets, U.S. stocks and ETFs by name or ticker and returns the id the other tools take
list_watchlistThe assets on the member's watchlist. Research runs only on these
list_public_reportsThe public research library: reports anyone can read, newest first
get_earnings_calendarThe 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):

ToolWhat it does
ask_sageSends 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_messagesReads the member's SAGE chat, including answers that finished later and notices that a run has completed
add_to_watchlistAdds assets to the member's watchlist
remove_from_watchlistRemoves assets from the watchlist, and with them what the member recorded there
create_research_projectCreates a project from analyses or a template. Nothing is priced, run or spent
update_research_projectChanges a project's name, description, analyses, coverage or report options. Starts nothing
archive_research_projectArchives a project
restore_research_projectBrings an archived project back
quote_research_runPrices one run of a saved project, without starting it
start_research_runStarts 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_runStops the run in progress. What it found so far is kept
refresh_connected_balancesRefreshes balances from the exchanges the member connected. Free, and it never returns an amount
turn_on_earnings_radarTurns on Earnings Radar for one stock: a report on each of its earnings releases, within the member's plan
turn_off_earnings_radarTurns 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.

Remote