AivelX MCP
Documentation for connecting AI assistants to AivelX
What AivelX MCP is
AivelX is a structured market-intelligence layer for AI and financial workflows. The AivelX MCP server lets an AI assistant retrieve AivelX market context directly — for one ticker, across several tickers, or across the whole covered universe — and explain it in the assistant’s own words.
It is built for questions that need calculated market structure rather than headlines: current directional structure across timeframes, Reversal Levels, pattern targets and target probabilities, Estimated Top and Estimated Bottom timing windows, active dynamic insights, sector and market breadth, upcoming earnings dates, and the historical reference counts behind those patterns.
Connection
| Remote MCP server URL | https://mcp.aivelx.com/connector |
|---|---|
| Transport | Streamable HTTP over HTTPS |
| Authentication | OAuth 2.0 (sign in with Google or an email magic link) |
Connections already using the earlier authenticated path New connections should use /connector.
Authentication
The connector uses OAuth 2.0. A standards-compliant client discovers AivelX automatically from the published metadata and completes sign-in without any server-side configuration:
- https://mcp.aivelx.com/.well-known/oauth-authorization-server
- https://mcp.aivelx.com/.well-known/oauth-protected-resource/connector
AivelX accepts standard client registration, and authorization uses PKCE (S256) with exact-match redirect URIs and single-use, short-lived authorization codes. Sign-in is by Google or by email magic link. The email you sign in with must match an active AivelX MCP entitlement. Access is bound to your AivelX account rather than to a device, so the same account can be connected from more than one client.
Account and plan requirements
An active AivelX MCP entitlement is required. Timeframe availability follows the AivelX plan on that account:
| Plan | Timeframes available |
|---|---|
| Basic | Intraday, Short Term |
| Pro | Intraday, Short Term, Medium Term |
| Premium | Intraday, Short Term, Medium Term, Long Term |
The health_check tool reports the connected account’s plan and the timeframes it is allowed to request.
Tools
The connector exposes fifteen tools. Every market tool is read-only.
| Tool | What it returns |
|---|---|
| health_check | Reachability, the connected account’s plan and its allowed timeframes |
| aivelx_about | What AivelX is, what it does and does not do, methodology at a public level, limitations and example prompts |
| aivelx_glossary | AivelX terminology and the concepts behind its public market context |
| aivelx_analyze | Multi-timeframe market context for one ticker, plus a structured visual summary |
| aivelx_compare | The same framework applied across two or more tickers |
| aivelx_market_snapshot | Market-wide timing and trend distribution for one timeframe |
| aivelx_timing | Timing pattern, trend distribution, Estimated Top and Estimated Bottom clusters, the latest Market Timing Index and bounded history |
| aivelx_insights | Active dynamic insights for a timeframe, grouped by type |
| aivelx_new_insights | What changed since the previous AivelX update |
| aivelx_sectors | Which sectors dominate current insights, and sector distribution |
| aivelx_predefined_risk | Tickers whose price is close to a timeframe Reversal Level, bucketed by predefined distance, with timing-window and trend filters |
| aivelx_screen | Rule-based screening across the covered universe or a supplied ticker list, using current AivelX context |
| aivelx_earnings | Upcoming earnings days for covered tickers, split into premarket and after-hours |
| get_display_preferences | The account’s saved display-wording preference |
| set_display_preferences | Saves a display-wording preference (presentation only) |
Earnings dates are calendar metadata associated with a ticker. They are not an AivelX price-pattern calculation.
Read-only by design
Every AivelX market tool is read-only. AivelX cannot place, modify, route or cancel a trade or an order, has no brokerage or exchange connection, and cannot move money, cryptocurrency or any other financial asset.
The only setting AivelX stores on your behalf through the connector is your display-wording preference.
Example prompts
- “Evaluate NVDA with AivelX in plain English.”
- “Find assets within 3% of their Short Term Reversal Level.”
- “Compare NVDA, TSM and SOXX across Short Term and Medium Term.”
- “What changed in AivelX today?”
- “Which sectors dominate current AivelX insights this week?”
- “Which covered tickers report earnings in the next two weeks?”
Data updates and freshness
- Coverage spans more than 1,400 assets across equities, ETFs, indices, futures, foreign exchange and crypto, and is expanding.
- During an instrument’s normal trading hours, every AivelX timeframe is recalculated hourly when fresh market data is available.
- For US stocks during premarket and after-hours trading, only the Intraday timeframe changes.
- A reading stays live and provisional while its price period is still open. It becomes confirmed for that period only when the period closes: Intraday at each four-hour close, Short Term at each daily close, Medium Term at each weekly close, Long Term at each monthly close.
- Tool responses carry the update timestamps that produced them.
Limitations
- AivelX context can be wrong, stale, incomplete or temporarily unavailable for a ticker.
- Estimated Top and Estimated Bottom windows are context drawn from historical pattern behaviour. They are not scheduled reversals and not guarantees.
- Reversal Levels mark where the active directional pattern may change. They are not automatic buy or sell instructions.
- AivelX does not know your objectives, capital, leverage, tax situation, liquidity constraints or risk tolerance unless you supply that context.
- Coverage keeps expanding, but some tickers may still be missing.
- Calculation can lag fresh market data by the time needed to recalculate after an hourly data update.
Financial information, not advice
AivelX provides market context only. This is not financial advice, not a recommendation, and not an instruction to buy or sell. AivelX does not provide personalized financial advice, does not guarantee returns, does not predict the future tick by tick, and does not execute trades. You keep judgment, accountability and risk decisions.
Connecting in Claude
- Open Customize → Connectors and choose Add custom connector.
- Name it AivelX.
- Use the remote MCP server URL https://mcp.aivelx.com/connector.
- Complete the AivelX authorization page: sign in with Google or request a magic link. Use the email that holds your AivelX entitlement.
- Once connected, ask health_check to confirm your plan and allowed timeframes.
Other MCP clients that support remote MCP over Streamable HTTP with OAuth 2.0 can connect to the same URL. The client should discover AivelX from the OAuth metadata; no per-client server configuration is needed.
Reconnecting and revoking access
If a session reports an authorization error, use Reconnect on the connector, or remove and re-add it to start a fresh authorization. Your account entitlement and saved display preference are unaffected.
To end access, remove the AivelX connector from your assistant. AivelX re-checks your entitlement on every request, so access also ends when your entitlement is deactivated. To revoke a connector credential or ask what is stored for your account, contact support.
Troubleshooting
| Symptom | Likely cause | What to do |
|---|---|---|
| Connector added but no tools appear | Authorization did not complete | Reconnect and finish the AivelX sign-in |
| “Authentication is required” | No valid token was sent | Reconnect the connector |
| Sign-in rejected | The email has no active AivelX entitlement | Check the plan on your AivelX account |
| A timeframe is not available | Your plan does not include it | Use an allowed timeframe or upgrade your plan |
| Ticker not in coverage | The symbol is outside the current universe | Try a covered symbol, or ask support to add it |
| Empty or stale result | Calculation is still in progress after a data update | Retry shortly |
Support: [email protected]
Privacy
What AivelX records when you use the connector is described in the AivelX Privacy Policy.
In short: AivelX records the tool used, whether it succeeded, and explicitly requested ticker symbols, linked to an internal AivelX account identifier. It does not receive your prompts, your conversation history, or the assistant’s generated answers.