{"openapi":"3.1.0","info":{"title":"Mboum (BYOK) API","version":"0.1.0","description":"Mboum (BYOK) lets an AI assistant read your own Mboum data through the Mboum API with a key you supply (Mboum personal access token). Read-only: 11 tools (get_quote, get_quotes, get_analyst_ratings, list_insider_trades, get_earnings_calendar, get_dividends_calendar, get_economic_events, get_ipo_calendar, get_stock_splits, get_unusual_options_activity, list_market_news). The BYOK key travels with...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-mboum.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-mboum/docs"},"termsOfService":"https://connectorbay.com/byok-mboum/terms"},"servers":[{"url":"https://byok-mboum.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-mboum/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/get_quote":{"post":{"operationId":"get_quote","summary":"Get the real-time quote of one ticker: last price, change, bid and ask, volume, market status and 52-week range. Each ca","description":"Get the real-time quote of one ticker: last price, change, bid and ask, volume, market status and 52-week range. Each call counts as 2 against the plan's request quota. Use for \"What is Apple's stock price right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Ticker symbol, for example AAPL.","maxLength":20,"title":"Ticker","type":"string"},"type":{"description":"Asset class: STOCKS, ETF, MUTUALFUNDS or FUTURES.","enum":["STOCKS","ETF","MUTUALFUNDS","FUTURES"],"title":"Type","type":"string"}},"required":["ticker","type"],"title":"get_quoteArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_quotes":{"post":{"operationId":"get_quotes","summary":"Get snapshot quotes for several tickers at once (stocks, futures, forex pairs such as EURUSD=X, indexes such as ^VIX, ET","description":"Get snapshot quotes for several tickers at once (stocks, futures, forex pairs such as EURUSD=X, indexes such as ^VIX, ETFs, crypto such as BTC-USD) with price, change, volume, market cap and P/E. Each call counts as 2 against the plan's request quota. Use for \"Compare the latest prices of SPY, EURUSD=X and BTC-USD\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Comma-separated symbols, for example 'AAPL,TSLA,EURUSD=X,^VIX,BTC-USD'.","maxLength":300,"title":"Ticker","type":"string"}},"required":["ticker"],"title":"get_quotesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_analyst_ratings":{"post":{"operationId":"get_analyst_ratings","summary":"Get analyst target estimates and weighted alpha for up to 10 tickers (US and Canadian equities). Each call counts as 2 a","description":"Get analyst target estimates and weighted alpha for up to 10 tickers (US and Canadian equities). Each call counts as 2 against the plan's request quota. Use for \"What is the mean analyst price target for AAPL and NVDA\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"description":"Comma-separated ticker symbols, at most 10, for example 'AAPL,NVDA'.","maxLength":100,"title":"Ticker","type":"string"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"required":["ticker"],"title":"get_analyst_ratingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_insider_trades":{"post":{"operationId":"list_insider_trades","summary":"List recent insider and congressional trades with person, role, ticker, side, estimated USD value and date. Filter by ti","description":"List recent insider and congressional trades with person, role, ticker, side, estimated USD value and date. Filter by ticker, type, minimum value or politicians only. Each call counts as 2 against the plan's request quota. Use for \"What did US Congress members trade recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only trades in this ticker.","title":"Ticker"},"type":{"anyOf":[{"enum":["Buy","Sell","Transfer"],"type":"string"},{"type":"null"}],"default":null,"description":"Trade type: Buy, Sell or Transfer.","title":"Type"},"min_value":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"Minimum transaction value in USD, for example 10000.","title":"Min Value"},"politicians_only":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"true to return only trades by US Congress members and Senators.","title":"Politicians Only"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_insider_tradesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_earnings_calendar":{"post":{"operationId":"get_earnings_calendar","summary":"List companies reporting earnings: report date and time, estimated and last reported EPS, price and volume. Filter by ti","description":"List companies reporting earnings: report date and time, estimated and last reported EPS, price and volume. Filter by ticker, a days window or a date range. Each call counts as 2 against the plan's request quota. Use for \"Which companies report earnings in the next 7 days\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only this ticker.","title":"Ticker"},"days":{"anyOf":[{"maximum":30,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Upcoming window in days (1 to 30); alternative to start_date and end_date.","title":"Days"},"start_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date YYYY-MM-DD.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"End date YYYY-MM-DD.","title":"End Date"},"price_min":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"Minimum share price filter.","title":"Price Min"},"optionable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"true to return only stocks with listed options.","title":"Optionable"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"get_earnings_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_dividends_calendar":{"post":{"operationId":"get_dividends_calendar","summary":"List dividends for a date: ticker, amount, yield, ex-dividend date and payable date. Each call counts as 2 against the p","description":"List dividends for a date: ticker, amount, yield, ex-dividend date and payable date. Each call counts as 2 against the plan's request quota. Use for \"Which stocks go ex-dividend on 2026-10-30\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Calendar date YYYY-MM-DD (current day when omitted).","title":"Date"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"get_dividends_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_economic_events":{"post":{"operationId":"get_economic_events","summary":"List global economic events with country, event name, actual, consensus and previous values. Each call counts as 2 again","description":"List global economic events with country, event name, actual, consensus and previous values. Each call counts as 2 against the plan's request quota. Use for \"What economic releases are scheduled today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_economic_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_ipo_calendar":{"post":{"operationId":"get_ipo_calendar","summary":"List IPOs for a month: proposed ticker, company, exchange, share price, shares offered, priced date and deal status. Eac","description":"List IPOs for a month: proposed ticker, company, exchange, share price, shares offered, priced date and deal status. Each call counts as 2 against the plan's request quota. Use for \"Which IPOs priced in October 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":7,"type":"string"},{"type":"null"}],"default":null,"description":"Month in YYYY-MM format (current month when omitted).","title":"Date"}},"title":"get_ipo_calendarArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_stock_splits":{"post":{"operationId":"get_stock_splits","summary":"List past, current and upcoming stock splits for a date with ticker, company, date and old and new share worth. Each cal","description":"List past, current and upcoming stock splits for a date with ticker, company, date and old and new share worth. Each call counts as 2 against the plan's request quota. Use for \"Which stock splits are coming up\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Calendar date YYYY-MM-DD.","title":"Date"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"get_stock_splitsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_unusual_options_activity":{"post":{"operationId":"get_unusual_options_activity","summary":"List option contracts trading at high volume relative to open interest, with underlying, strike, expiry, bid/ask, volume","description":"List option contracts trading at high volume relative to open interest, with underlying, strike, expiry, bid/ask, volume, open interest, volatility and delta. Each call counts as 2 against the plan's request quota. Use for \"Which stock options show unusual volume today\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"type":{"description":"Asset class: STOCKS, ETFS or INDICES.","enum":["STOCKS","ETFS","INDICES"],"title":"Type","type":"string"},"ticker":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only this underlying ticker.","title":"Ticker"},"date":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Historical date YYYY-MM-DD.","title":"Date"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"required":["type"],"title":"get_unusual_options_activityArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_market_news":{"post":{"operationId":"list_market_news","summary":"List market news and press releases, optionally for one ticker, with title, source, tickers and time. Each call counts a","description":"List market news and press releases, optionally for one ticker, with title, source, tickers and time. Each call counts as 2 against the plan's request quota. Use for \"What is the latest news on AAPL\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"ticker":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only news about this ticker.","title":"Ticker"},"type":{"anyOf":[{"enum":["ALL","MARKET","VIDEO","PRESS-RELEASE"],"type":"string"},{"type":"null"}],"default":null,"description":"News type: ALL, MARKET, VIDEO or PRESS-RELEASE.","title":"Type"}},"title":"list_market_newsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}