Connect Dividend Data to Your AI Agent
Connect Claude, ChatGPT, Grok, Cursor, Hermes, OpenClaw or another MCP agent to research stocks and funds and to read and add to your watchlist and portfolio.
Your AI agent can use Dividend Data the way you do: research any stock or fund (financial statements, company KPIs, price history, valuation, analyst estimates, earnings calls and dividends), run the Stock Screener, build charts, and read and add to your own watchlist and portfolio. It sees the same numbers the site shows, with a link back to the page each one came from.
Connect
- Copy the connector address:
https://www.dividenddata.com/mcp - In your agent's settings, add a custom connector (also called an MCP server) and paste the address.
- Sign in with your Dividend Data account when it asks, and approve the connection.
Any agent that supports MCP connectors with sign-in works. The steps for the most common ones are below, and every app has its own step-by-step page on Connections.
Setup by Agent
Claude
- In Claude on the web or desktop, open Customize, then Connectors, and choose Add custom connector from the + menu.
- Name it Dividend Data and paste the connector address:
https://www.dividenddata.com/mcp - Choose Continue, keep the sign-in settings Claude finds, and choose Add.
- Sign in with your Dividend Data account when it asks, and approve access.
Custom connectors work on every Claude plan: Free, Pro, Max, Ultra, Team and Enterprise. On Free, Claude holds one custom connector.
Once added, it works in Claude for iOS and Android too. Turn it on in a chat from the + menu, under Connectors.
On a Team or Enterprise plan, an Owner adds it first: Organization settings, Connectors, Add, then Custom and Web. Then choose Connect on it under Customize, Connectors.
ChatGPT
Official Plugin
- Open Dividend Data in the ChatGPT Plugin Directory, or open Plugins in ChatGPT's sidebar and search for Dividend Data.
- Choose Install plugin or Connect, sign in with your Dividend Data account and approve access.
- Ask away in any chat: ChatGPT uses Dividend Data when your question needs it, or type @ and pick Dividend Data.
Custom MCP Server
- On chatgpt.com, open Plugins, choose +, then Add custom MCP server.
- Name it Dividend Data and paste the connector address as the Server URL:
https://www.dividenddata.com/mcp - Set authentication to OAuth, tick I understand and want to continue, then choose Create as a plugin.
- Sign in with your Dividend Data account when it asks and approve access. In a new chat, type @ and pick Dividend Data.
The official plugin is the quickest way in. ChatGPT shows its plugin directory on every plan; whether a plugin installs also depends on your workspace and region.
In an Enterprise or Edu workspace, an admin may need to make Dividend Data available before you can install it. Business workspaces have apps on by default.
The Custom MCP Server way is for ChatGPT Business, Enterprise, Edu and Pro. On Pro, a custom server can read but not save, so it can't add to your watchlist or portfolio.
ChatGPT may ask you to confirm before Dividend Data saves anything to your watchlist or portfolio.
Grok
- Go to grok.com/connectors and choose New Connector, then Custom.
- Paste the connector address:
https://www.dividenddata.com/mcp - Sign in with your Dividend Data account when it asks, and approve access.
On Grok Business and Enterprise, a team admin adds the connector first.
Gemini
- On a computer, go to gemini.google.com and open Settings, then Connected Apps (inside Personal Intelligence if you don't see it).
- Under Custom apps, choose Add a custom app and paste the connector address:
https://www.dividenddata.com/mcp - Choose Next, then sign in with your Dividend Data account and approve access.
Custom apps need a personal Google account (not work or school) in the US, age 18 or older, with Keep Activity on and Gemini set to English.
Once added, it works in the Gemini mobile app too. Gemini asks you to confirm before anything is saved to your watchlist or portfolio.
Perplexity
- In Perplexity, open Plugins in the sidebar (or Customize, then Connectors), choose Add custom, then Add MCP connector, then Remote.
- Name it Dividend Data and paste the connector address into MCP server URL:
https://www.dividenddata.com/mcp - Under Advanced, set Authentication to OAuth, tick the acknowledgement and choose Add.
- Select the Dividend Data card, sign in with your Dividend Data account and approve access.
On Perplexity Enterprise, an admin turns on Allow members to add custom connectors first.
Grok Bot
In a Chat
- In a chat with your Bot, ask:
Add a custom MCP server called dividend-data at https://www.dividenddata.com/mcp - If it asks you to confirm, check the address and approve it.
- Choose Authorize on the Connect card, sign in with your Dividend Data account and approve access.
Desktop App
- In the Grok Bot desktop app, open Connect apps and choose Add a custom connector at the bottom.
- Name it Dividend Data, set Type to Remote HTTPS, leave Client ID empty and paste the connector address into Server URL:
https://www.dividenddata.com/mcp - Choose Add plugin, then Authenticate, and sign in with your Dividend Data account and approve access.
Grok Bot comes with X Premium and higher, or a linked SuperGrok plan.
Hermes Agent
- Add the connector:
hermes mcp add dividend-data --url https://www.dividenddata.com/mcp --auth oauth - Sign in with your Dividend Data account in the browser that opens, then press Enter to keep every tool.
- Start a new session, or send
/reload-mcpin an open one.
No browser on this machine? Run hermes mcp login dividend-data --flow device and open the address it prints on any device.
OpenClaw
- Stop the Gateway (OpenClaw changes its MCP servers only while it is stopped):
openclaw gateway stop - Add the connector:
openclaw mcp add dividend-data --url https://www.dividenddata.com/mcp --transport streamable-http --auth oauth - Sign in, open the address it prints and approve access with your Dividend Data account:
openclaw mcp login dividend-data - Check the connection:
openclaw mcp doctor dividend-data --probe - Start the Gateway again:
openclaw gateway start
You can also add it in OpenClaw's Control UI, opened at the Gateway's own address: Settings, MCP, Add server (Streamable HTTP), set its auth to oauth, then choose Sign in on its row.
Claude Code
- Add the connector for all your projects:
claude mcp add --transport http --scope user dividend-data https://www.dividenddata.com/mcp - Start Claude Code, run
/mcp, choose dividend-data and sign in with your Dividend Data account in your browser.
Signed in to Claude Code with your Claude account? A Dividend Data connector you added in Claude already shows in /mcp, with no command.
Cursor
Install Link
- Choose Add to Cursor and confirm the install when Cursor opens.
- Open Customize, find dividend-data and sign in with your Dividend Data account in the browser that opens.
Config File
- Add this to
~/.cursor/mcp.json(or.cursor/mcp.jsonfor one project):{ "mcpServers": { "dividend-data": { "url": "https://www.dividenddata.com/mcp" } } } - Save the file, open Customize, find dividend-data and sign in with your Dividend Data account in the browser that opens.
Another Agent or Your Own
Use these settings in any MCP client:
- Address:
https://www.dividenddata.com/mcp - Transport: Streamable HTTP
- Sign-in: OAuth 2.1 with PKCE. Clients register with a client metadata document or dynamic client registration, and a machine with no browser can use device sign-in.
- Discovery:
https://www.dividenddata.com/.well-known/oauth-protected-resource/mcp - MCP Registry:
com.dividenddata/terminal
There are no API keys. Every connection signs in as one member and gets that member's plan.
What Your Agent Gets
Your agent gets what your plan gets on the site.
- Free: everything that is free on the site, plus your watchlist and portfolio. As on the site, history covers the last five years, a chart is one ticker and one metric, and dividend news covers the last 30 days. Pro tools and Pro cards (the Stock Screener, Value Graph, Intrinsic Value, Strategies, analyst estimates, earnings call transcripts, safety grades, Total Return) say they are part of Pro.
- Pro: everything.
Your agent can make up to 100 requests a day on Free and 2,000 on Pro. Connecting does not use your data credits.
Getting Started
Ask your agent to "get started with Dividend Data". It looks at your account, asks what you want to do, and suggests things to try. The quickest way to set up a portfolio: share a screenshot of your brokerage's positions page, or paste your holdings, and ask your agent to add them. Turn on Allow Changes first (below). On the Portfolio page, Add & Import › Ask AI to Add (or, on an empty Portfolio, Ask Claude or ChatGPT to Add Them) writes that prompt for you, with the switch beside it, and the page shows the new holdings when you come back to it.
Every stock page card has a starting point too: open Use This Data at the bottom of the card and pick your AI app. You get a prompt written for that card's data. If the app isn't connected yet, the panel walks you through it and the prompt waits for you at the end of the app's setup page; once it is connected, Ask starts a new chat in the app with the prompt. Portfolio cards have the same Use This Data band, on the Overview and on the Holdings, Dividends, Diversification and Forecast tabs (Forecast is Pro), with questions about your holdings; on a table with several views (Table or Heat Map, the Dividend Insights views, Group By), the questions follow the view you're on.
What It Can Change
A connected agent reads your watchlist and portfolio. It can add to them only after you turn on Allow Changes in Settings, under AI Agents, or beside a Portfolio prompt that adds holdings (the same switch). It is off until you do, and you can turn it off at any time.
With it on, your agent adds when you ask: tickers to a watchlist (on Pro, to a new list it makes for you), and holdings to a manual portfolio account (never one linked to a brokerage; if all of yours are linked, it asks what to call a new manual account and makes it when you agree). It follows the same rules as the Portfolio and Watchlist pages. Before it saves holdings, it is told to show you the table and wait for your OK, so check the shares and costs against your statement. Your AI app may also ask you to approve each change. Anything added can be edited or removed on the Portfolio and Watchlist pages.
It cannot remove or edit anything, change your settings or alerts, trade or move money: you do those on the site.
Ready-Made Recipes
Agents that show prompts (slash commands) list ready-made recipes: get started, add your holdings, check your portfolio's dividend safety, find dividend stocks near 52-week lows, compare two funds, a what-if with dividends reinvested, your holdings' upcoming dates, and building a chart. Ask your agent for "Dividend Data recipes" if it does not show them.
Disconnect
Remove the connector in your agent's settings, and that agent stops using it. To cut off every connection your account has made (a lost device, an app you no longer trust), contact support: we turn it off on our side at once.
Frequently Asked Questions
Does my agent see other members' data?
No. A connection reads only the account that signed in.
Is it the same data as the site?
Yes. Every number comes from the same pages, in the display currency you picked on the site while signed in (US dollars if you never picked one), unless your agent asks for another currency.