NEWIntroducing Portfolio Doctor, a daily checkup for your sharesTake a look →

How to use StockYan in Claude, ChatGPT and Gemini

Add StockYan to your AI app in about a minute, then ask about NEPSE in plain words. Setup for every app, what to ask, and how to fix the usual snags.

10 min read

What you need

  • A StockYan account, the same one you use in the app. Free is fine.
  • An AI app that supports MCP connectors: Claude, ChatGPT, Gemini, Perplexity, Le Chat, Claude Code, Cursor, VS Code or another MCP app.
  • The connector link: https://stockyan.astrixel.com/mcp

Claude (web, desktop and phone)

No button handy? In Claude go to Customize, then Connectors, press +, choose Add custom connector and paste https://stockyan.astrixel.com/mcp. It works in Claude on the web, desktop and phone. Free Claude accounts can add one custom connector.

  1. Press Add to Claude on stockyan.com. Claude opens Add custom connector with StockYan already filled in.
  2. Click Add, then Connect.
  3. A StockYan sign-in page opens. Sign in with Google or your email, check what Claude will be able to do, and press Allow.
  4. Back in Claude, start a new chat and ask: How is NEPSE doing today?

ChatGPT

Custom MCP servers are not on every ChatGPT plan. If you don't see Add custom MCP server, your plan may not allow it yet.

  1. Open chatgpt.com/plugins on the web. The Add to ChatGPT button copies the link and opens it.
  2. Click +, then Add custom MCP server. Name it StockYan, paste https://stockyan.astrixel.com/mcp and choose OAuth.
  3. Accept the warning, click Create, then install it.
  4. Sign in with your StockYan account on the page that opens and press Allow.
  5. In a new chat, ask your question.

Gemini, Perplexity and Le Chat

Each app then opens the StockYan sign-in page. Sign in and press Allow. Menu names change often: if yours differs, look for Connectors or Custom app.

  • Gemini: on gemini.google.com open Settings, then Connected apps, then Add a custom app, and paste https://stockyan.astrixel.com/mcp. Google offers this to personal accounts in the US (18+) for now. Anywhere else, Gemini CLI works: gemini mcp add --transport http stockyan https://stockyan.astrixel.com/mcp
  • Perplexity: open Settings, then Connectors, then Custom connector, choose Remote, paste the link and pick OAuth. Custom connectors are on Perplexity Pro, Max and Enterprise.
  • Le Chat (Mistral): open Connectors, then Add connector, then Custom MCP connector, and paste the link. Le Chat finds the sign-in on its own.

Claude Code

Run this once in your terminal:

Then type /mcp inside Claude Code, choose stockyan and sign in. Claude Code opens the StockYan sign-in page in your browser.

Command

claude mcp add --transport http stockyan https://stockyan.astrixel.com/mcp

Cursor and VS Code

Both have one-click install. Press Cursor or VS Code in the Also in row on stockyan.com, confirm the install in the app, and sign in when it asks. You can also add it by hand as a remote MCP server with the link above.

Signing in and the Allow screen

Every app sends you to the same StockYan page. Sign in with Google or your email and password, the same account as the app. You'll see your name and plan, and a list of what the AI app will be able to do.

Make changes when you ask is ticked by default. Untick it if you only want the AI to read your data. You can connect again later to change your mind.

NEPSE Trading Desk: research like a professional desk

The connector also brings the NEPSE Trading Desk, a free, open-source research method your AI follows step by step: it reads the market's mood, looks for ideas with several strategies, scores each one with four analysts, checks which brokers are buying, argues the pros and cons, plans the entry, stop and position size, runs a risk check, backtests the setup, and writes a report in plain words with simple visuals. It never tells you to buy or sell and never places real orders.

The desk is open source at github.com/AstrixelHQ/nepse-trading-desk.

  • Claude, ChatGPT, Gemini and the other apps: nothing extra to install. Once the connector is added, just ask "What should I buy this week?" or "Is NABIL worth buying now?".
  • Claude Code: one command installs the desk and the connector together: claude plugin install nepse-trading-desk --marketplace AstrixelHQ/nepse-trading-desk
  • Gemini CLI: gemini extensions install https://github.com/AstrixelHQ/nepse-trading-desk
  • Cursor, Codex and other agents: npx skills add AstrixelHQ/nepse-trading-desk

30 things to ask

TopicAsk
MarketHow did NEPSE close today? Which sectors led and lagged?
MarketWhat are today's top gainers, losers and most traded stocks?
MarketHow has NEPSE done in December in past years?
StockTell me about NICA: price, P/E, book value, dividends.
StockShow UPPER's price over the last 6 months and where support is.
StockWhat's the latest news on Nepal Telecom?
StockFind companies similar to NABIL and compare them.
ScannersWhich stocks are oversold on RSI today?
ScannersAny bullish MACD crossovers in hydropower?
ScannersWhich stocks closed above their upper Bollinger Band?
ScannersFind stocks trading 3 times their usual volume.
ScannersProfitable companies with P/E under 20 and P/B under 2.
ScannersAny swing-trade breakouts today?
BrokersWho are the top buyers and sellers of GBIME this week?
BrokersWhich stocks do the top buyers dominate this week?
BrokersWhich brokers are aggressively accumulating banks?
BrokersAny matched buy and sell deals today?
BrokersShow today's bulk transactions.
PortfolioWhat's my total profit after tax?
PortfolioWhich holding has done worst, and why?
PortfolioHow much would I get if I sold all my TAMOR today?
PortfolioRecord a buy of 50 NABIL at Rs 540 today.
AlertsAlert me if KBL goes above Rs 250.
AlertsWhich of my alerts are still active?
WatchlistsAdd these three stocks to my hydro watchlist.
JournalSave a note: watching UPPER for a breakout above 200.
IPOWhat IPOs are open or coming up?
Paper tradingBuy 100 SHIVM in paper trading at today's price.
LearningExplain RSI divergence using a real NEPSE stock.
LearningWhat does my portfolio's sector spread say about my risk?

Tips for better answers

  • Use stock symbols when you know them, like NABIL or UPPER.
  • Say the timeframe: today, this week, this month.
  • Ask follow-ups in the same chat. The AI keeps the context.
  • Ask the AI to show its numbers if you want to check them.
  • Market data after 3 PM is the closing data; during trading hours, Monday to Friday 11:00 to 15:00, prices are live.

If something goes wrong

ProblemWhat to do
"Request failed" on the Allow screenThe server may have been restarting. Wait a few seconds and connect again from the AI app.
The sign-in page says it expiredGo back to the AI app and press Connect again. Sign-in links last a few minutes.
The AI says a tool needs ProThat tool follows your StockYan plan, same as the app.
The AI doesn't use StockYanMake sure the connector is on for this chat, then mention StockYan in your question.
Wrong account connectedRemove StockYan in the AI app's settings and connect again with the right account.
Apple sign-in missingOn the web, use Google or email for now.

Privacy in short

  • You sign in on StockYan's page, never inside the AI app.
  • The AI can see market data and your StockYan portfolios, watchlists, alerts, notes and journal.
  • It can never see your MeroShare password or PIN, make payments, apply for IPOs or place real trades.
  • Remove it any time from the AI app's settings.

Questions

Can I use StockYan with ChatGPT?

Yes. Open chatgpt.com/plugins, click +, choose Add custom MCP server and paste the StockYan link, then sign in with your StockYan account and press Allow. Custom servers depend on your ChatGPT plan.

Can I use StockYan with Claude?

Yes. Press Add to Claude on stockyan.com (or in Claude go to Customize, Connectors, Add custom connector and paste the StockYan link), then sign in and press Allow. It then works on Claude's web, desktop and phone apps.

Do I need StockYan Pro?

No. Market data, stock details, broker activity, your portfolio, watchlists, alerts and paper trading work on the free plan. Scanners and smart-money tools need Pro or Max, same as the app.

Does the AI give financial advice?

No. It reads StockYan's data and explains it. Treat the answers as research, not advice, and check anything important in the app.

Is my data safe?

You sign in on StockYan's own page and choose what the AI can do. It can't see your MeroShare login, make payments, apply for IPOs or place real trades, and you can remove it any time.