Marketstack MCP server

Connect Marketstack to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Marketstack MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the search sec filings tool in Marketstack
  • Use the search tickers tool in Marketstack
  • Use the get intraday prices tool in Marketstack
  • Use the get etf holdings tool in Marketstack
  • Use the get sec financial data tool in Marketstack
  • Use the get government bonds tool in Marketstack

Supported Tools

search_sec_filings

Search SEC Filings

Search SEC EDGAR filings by company name or CIK code. First resolves the first company-name match to its CIK code, then retrieves submission history. Provide an exact CIK when names are ambiguous. Supports filtering by form type (8-K, 10-K, 10-Q, Form 4, etc.) and date range. You can also provide a CIK code directly to skip the lookup step.

search_tickers

Search Tickers

Search for stock tickers by name, symbol, or exchange. Returns matching tickers with company name, symbol, country, and exchange information. Use this to find ticker symbols before querying price data.

get_intraday_prices

Get Intraday Prices

Retrieve intraday stock price data with configurable intervals from 1 minute to 24 hours. Returns open, high, low, close, last, and volume for each interval. Use `latest` mode to get the most recent intraday prices. Available for US stock tickers on the IEX exchange.

get_etf_holdings

Get ETF Holdings

Retrieve complete ETF holdings data by ticker, including fund metadata and individual security holdings with balances, values, weights, asset categories, and ISINs. Supports date range filtering.

get_sec_financial_data

Get SEC Financial Data

Retrieve XBRL financial data from SEC EDGAR filings. Supports two modes: - **Company facts**: Get specific financial metrics (e.g. US-GAAP accounts payable) for a company across all filings by CIK code. - **Frames**: Retained generalized frames request for existing clients. Use get_accounts_payable_frames for the current documented US-GAAP AccountsPayableCurrent frame API.

get_government_bonds

Get Government Bonds

Retrieve 10-year government bond yield data for 53+ countries. Returns yield, daily price change, and weekly/monthly/yearly percentage changes. Use the search parameter to filter by country name within the requested country-list page. Fetches a list page, then one detail request per matching country.

get_splits_and_dividends

Get Splits & Dividends

Retrieve historical stock split factors and/or dividend payment information for one or more tickers. Specify the `type` field to fetch splits only, dividends only, or both. Supports filtering by date range.

get_commodities

Get Commodity Prices

Retrieve current or historical commodity prices by commodityName, including energy, metals, agriculture, and livestock. Use download_catalog to discover supported names. Dates or frequency select history; limit, offset, and sort apply locally to the returned commodity records. The legacy symbols-only request is retained, but is not described by the current API reference.

list_exchanges

List Exchanges

List and search supported stock exchanges worldwide. Returns exchange name, MIC code, country, city, timezone, and currency information. Use this to discover available exchanges and their MIC codes for filtering other queries.

get_market_indices

Get Market Indices

Retrieve data for 86+ global stock market indices and benchmarks. Returns current price, daily/weekly/monthly/yearly percentage changes for each index. Use the search parameter to filter by name or country within the requested list page. Fetches one list page and one detail request per listed benchmark; use get_market_index to query a known benchmark directly.

get_ticker_details

Get Ticker Details

Retrieve detailed company information for a specific ticker symbol, including company name, country, exchange details, and data availability. Useful for looking up metadata about a particular stock.

get_eod_prices

Get End-of-Day Prices

Retrieve end-of-day (closing) stock prices including open, high, low, close, volume, and adjusted values. Supports historical data up to 15 years with filtering by date range, exchange, and multiple symbols. Use `latest` mode to get the most recent closing prices.

get_analyst_ratings

Get Analyst Ratings

DEPRECATED — use `get_company_ratings` instead. Retrieve current and historical analyst buy/sell/hold ratings for stocks, including consensus data, price targets, and individual analyst recommendations. Supports up to 15+ years of history with date range filtering.

list_timezones

List Timezones

List supported IANA timezones and their standard and daylight-saving abbreviations.

get_company_ratings

Get Company Analyst Ratings

Retrieve analyst buy/sell/hold ratings and consensus price targets for exactly one company ticker through the current company-ratings API. Returns the provider company metadata, consensus, individual rating records, and complete response.

list_currencies

List Currencies

List supported currencies, including currency codes, names, and native symbols.

list_etfs

List ETFs

Discover available ETF ticker symbols before retrieving their holdings.

get_realtime_prices

Get Real-Time Stock Prices

Get the last known stock price across exchanges, with currency and the provider trade timestamp.

get_market_index

Get Market Index

Retrieve a single benchmark quote directly without listing and fetching every index. Use get_market_indices to discover benchmark names.

get_company_profile

Get Company Profile

Get extended company information by ticker, including industry, sector, executives, addresses, and listings when provided.

get_accounts_payable_frames

Get Accounts Payable Frames

Get the latest SEC AccountsPayableCurrent fact per reporting entity for a calendar frame, using the documented US-GAAP accounts-payable API. Returns company identities and reported values in the original frame data.

download_catalog

Download Market Data Catalog

Download the provider-published supported ticker, end-of-day ticker, or commodity catalog to discover query identifiers.

Connect Marketstack to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Marketstack in Metorial. In your Metorial portal, enable the Marketstack MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Marketstack tools.

Run Marketstack through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Marketstack and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Marketstack tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Marketstack

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Shopify

Manage e-commerce stores including products, orders, customers, inventory, and fulfillment. Create and update products with variants, images, and metafields. Process and track orders, draft orders, refunds, and transactions. Manage customer records, addresses, and marketing consent. Track and adjust inventory levels across multiple locations. Handle fulfillment workflows including routing to warehouses and third-party logistics. Create and manage discount codes, price rules, and automatic discounts. Configure shipping rates, carrier services, and delivery profiles. Build custom storefronts with cart management and checkout via the Storefront API. Manage content including pages, blogs, articles, and themes. Support B2B commerce with company profiles, catalogs, and custom pricing. Receive webhooks for events across orders, products, customers, inventory, fulfillment, collections, carts, checkouts, disputes, and more.

Technical notes for Marketstack

Retrieve real-time, intraday, and historical stock market data for 30,000+ tickers across 70+ global exchanges. Look up end-of-day and intraday prices, live stock quotes, commodity prices, government bond yields, ETF holdings, and stock market indices. Access company information, analyst ratings, stock splits, and dividend history. Search SEC EDGAR filings, company submissions, and XBRL financial data. Query reference data for exchanges, currencies, and timezones.

Frequently asked questions

Common questions about connecting Marketstack to AI agents with Metorial.

  1. How many tools does the Marketstack MCP server have?
    The Marketstack MCP server exposes 22 tools, including Search SEC Filings, Search Tickers, Get Intraday Prices. Each one is governed and traced through Metorial.
  2. Marketstack exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Marketstack MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Marketstack and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Marketstack MCP server yourself or use the hosted gateway.

Connect Marketstack to production AI agents

See how Metorial gives your team governed access to Marketstack, with tracing and security controls built in.