Welcome to our new support center!
We provide 24x7 support by human agents! So if our documentation can’t help you out, feel free to reach out and create a ticket!

Altrady Support Altrady Support

How do I connect Claude or another AI assistant to Altrady with MCP?

MCP lets an AI assistant like Claude, ChatGPT, Cursor, or Claude Code read your Altrady account, analyze your charts, and prepare actions for you. You add Altrady as a connector in your assistant, sign in when it asks, and you’re ready to go. It takes about two minutes.

Before you start

There is nothing to install or switch on in Altrady. MCP works with the Altrady desktop app and in the browser, and there are no tokens to copy, no config files to edit, and no extra software such as Node.js to set up.

Two things to have ready:

  • An AI assistant that supports MCP connectors, such as Claude, ChatGPT, Cursor, or Claude Code. A free Claude account works; usage limits reset every 5 hours.
  • An Altrady window open, either the desktop app or Altrady in your browser. Anything that happens inside Altrady, like drawing on a chart or filling in a form, runs in the window you have open. If you haven’t installed the desktop app, see Install Altrady.

If you set up MCP before Altrady 6.0

Before 6.0, MCP ran on your own computer and needed a token and an entry in your assistant’s config file. That local server is gone, so the old setup no longer connects. To switch:

  1. Remove the old altrady entry from your assistant. In Claude Desktop, go to Settings > Developer, click Edit Config, delete the altrady block, and save the file.
  2. Fully quit your assistant and open it again. In Claude Desktop on Windows, right-click its icon in the system tray and choose Quit. On Mac, use Cmd+Q.
  3. Add Altrady as a connector, as described below. You don’t need the old token any more.

Add Altrady as a connector

Settings MCP server page with the Connect an AI assistant card showing the Connector URL and Claude Code command with Copy buttons🔍 Click the image to see a larger version

  1. In Altrady, go to Settings and open MCP server. The page is titled MCP AI assistant.
  2. Find the Connect an AI assistant card.
  3. Next to Connector URL, click Copy.

That URL is all your assistant needs. Keep the page handy for the next step.

Connect your assistant

Follow the line that matches the assistant you use.

Claude Code: on the same card, click Copy next to Claude Code, paste the command into your terminal, and run it. It adds Altrady as a connector in one step.

Claude, ChatGPT, Cursor, or another MCP client: open the connectors (or MCP servers) section in your assistant’s settings, add a new custom connector, and paste the Connector URL you copied. The exact menu names depend on the assistant, so look for the option to add a connector by URL.

When your assistant asks you to sign in, sign in with your Altrady account. That’s the only login step.

Don’t worry if your assistant asks a follow-up question or two during setup. That’s normal; just answer and let it continue.

Confirm the connection

Ask your assistant something simple to check that it can reach your account:

Use the Altrady MCP to call get_session_context and tell me which exchange account is active.

If that returns your account info, you’re set. If it doesn’t, make sure an Altrady window is open and that you finished signing in when your assistant asked.

What it can and can’t do

Your AI assistant can read things like your positions, alerts, bots, watchlists, and market data, and it can analyze charts and draw levels. It can also create and manage bots, alerts, and watchlists, and close or cancel existing positions.

Every action that changes your account shows a confirmation popup in Altrady summarizing what it’s about to do. Nothing happens until you click the popup’s confirm button, which is named after the action (for example Create bot or Allow), and an unanswered popup cancels itself after 5 minutes. The one exception is opening a new trade: the assistant loads it into Altrady’s trading panel, and you review the fields and submit it yourself.

Some actions depend on your plan. If your plan doesn’t include an action, or you’ve reached a plan limit, Altrady shows the upgrade options and the assistant tells you it was refused. If you’re not sure what your plan includes, see Choose your plan.

What you can ask

Once connected, you can have natural conversations with your assistant about your Altrady data. No copy-pasting or exporting needed. Here are some examples without any skills installed:

Positions: “Show me my open positions.” / “What’s my P&L on the ETH-USDT position?” / “Have any of my positions been open more than 48 hours?”

Bots: “List my signal bots and grid bots.” / “How is my BTC grid bot performing?”

Markets and prices: “What’s the current price of SOL-USDT?” / “Show me the last 100 1h candles for ETH-USDT.”

Alerts and watchlists: “What alerts do I have set?” / “What’s in my Layer 1s watchlist?”

Backtests: “List my recent backtests.” / “Show me the summary stats for my latest backtest.”

For guided workflows like daily check-ins, market scans, technical analysis, and position management, add the skills below.

Adding skills

Skills are guided workflows that help your AI assistant perform specific Altrady tasks. They’re optional but make the integration much more useful.

What each skill does

Pick the ones that match how you trade, or add all of them.

  • altrady-morning-check: a daily account briefing. Summarizes open positions, recently triggered alerts, bot performance, and watchlist movers.
  • altrady-market-scanner: finds trade candidates by criteria like breakouts, volume spikes, trend strength, or mean reversion, and returns a ranked shortlist.
  • altrady-technical-analysis: a multi-timeframe read of a chart. Identifies trend, support/resistance, and structure; applies indicators; draws levels on the active chart.
  • altrady-risk-sizer: calculates position size from your risk percentage. You provide risk %, entry, stop loss, and leverage; it returns size and required margin.
  • altrady-backtest-analyzer: analyzes a replay backtest with win rate, drawdown, fee drag, and (if you share your rules) per-trade deviations from your stated strategy.
  • altrady-trade-review: reconstructs the chart context of a closed trade, summarizes what happened (R-multiple, hold time, max drawdown), and asks one targeted question about the lesson.
  • altrady-smart-entry: turns a trade idea into a sized, multi-take-profit setup. Calculates size, places stop loss at structure, staggers take-profits, and pre-fills the trade panel for your review.
  • altrady-position-manager: reviews each open position and flags actions to consider: move stop loss to break-even, set a trail, take partial profit, close stagnant positions. Confirms each one with you individually.
  • altrady-alert-manager: creates alerts anchored to chart structure rather than arbitrary prices, or audits existing alerts and prunes stale or duplicate ones.
  • altrady-watchlist-curator: builds themed watchlists, scans an existing list for today’s movers, or prunes stagnant and illiquid tickers.
  • altrady-signal-bot-builder: walks through a DCA signal bot setup interview (capital, safety orders, deviation, take profit), computes the full ladder, and presents a configuration to confirm.
  • altrady-grid-bot-builder: derives a grid bot configuration for the current market regime from recent price action and volatility, and presents it for your confirmation.

Download the skills

  1. Go to github.com/altrady/altrady-mcp.

  2. Click the green Code button, then Download ZIP.

  3. Extract the ZIP to a folder you can find easily, for example Documents\altrady-mcp.

  4. Inside the extracted folder, open the skills subfolder. You’ll see one folder per skill, each containing a SKILL.md file.

    🔍 Click the image to see a larger version

Upload each skill to Claude Desktop

  1. In Claude Desktop, navigate to Customize.

    🔍 Click the image to see a larger version

  1. Select Create New Skills.

    🔍 Click the image to see a larger version

  1. Click the + to add a new skill, then + Create Skill, then Upload a skill.

    🔍 Click the image to see a larger version

  1. Drag the SKILL.md file from one of the skill folders, or click to browse and select it.

    🔍 Click the image to see a larger version

  1. Repeat the previous two steps for each skill you want to upload. After uploading all of them, the list will look like this:

    🔍 Click the image to see a larger version

Try them out

Go back to the chat and start using the skills. A good first prompt:

Tell me about the Altrady MCP skills you have available.

Or trigger one naturally:

Do a morning check on my Altrady account.

Run technical analysis on BTC-USDT.

Things to know about skills in Claude Desktop

  • On the free Claude plan, multi-step skills use your tokens quickly. Usage resets every 5 hours.
  • Read and analysis skills work well in Claude Desktop: daily check-ins, market scanning, technical analysis, risk sizing, backtest analysis, and position monitoring.
  • Skills that perform write actions in Altrady (creating alerts, editing watchlists, modifying positions, setting up bots) haven’t been fully verified in Claude Desktop yet. Use the Altrady app directly for those for now.
  • The altrady-trade-review skill normally saves journal entries to a file on your computer, which Claude Desktop can’t do by default. The skill still produces the journal entry in chat; you can copy it to your own file.

Still stuck?

If your assistant can’t reach Altrady, double-check that an Altrady window is open (the desktop app or Altrady in your browser) and that you finished signing in when your assistant asked. Then try removing the connector in your assistant and adding it again with the Connector URL from Settings > MCP server.

“Access to app.altrady.com was denied”

If the sign-in page says Access to app.altrady.com was denied. You don’t have the user rights to view this page., remove the connector, add it again, and sign in again. Your assistant may still be holding on to an earlier sign-in attempt, and adding the connector again starts a fresh one.

In Claude Code:

  1. In your terminal, run claude mcp list to see the connector’s name, then claude mcp remove followed by that name.
  2. In Altrady, go to Settings > MCP server, click Copy next to Claude Code, paste the command into your terminal, and run it.
  3. In Claude Code, type /mcp, choose Altrady, and sign in with your Altrady account.

If none of that clears it up, reach out through Get help; we’re happy to walk through it with you.

Was this article helpful?