Pulse MCP

Market quotes and your watchlist,
right in your AI agent.

Pulse for Mac has a built-in MCP server. Turn it on and Claude, Cursor, Codex or any MCP client gets live quotes for your watchlist and symbol search across markets. It can also edit your watchlists and track your positions and trades. It runs on your Mac at 127.0.0.1 and answers only to your token.

Set it up Download free trial

Built into Pulse for Mac · macOS 14+ · 15 tools · Streamable HTTP

›get_quotes  us:NVDA hk:700NVDA 181.20 +1.8%  ·  700 382.40 −0.6%›search_symbols  Toyotajp:7203  Toyota Motor›add_symbol  jp:7203 → Asiaok›record_trade  buy 10 NVDA @ 120qty 10 · avg 120.00

A stock quote MCP for your agent.

Ask your agent what the market is doing. It reads live quotes for everything on your Pulse watchlist and finds any other symbol by name or ticker.

Every market Pulse tracks

US, Hong Kong, China, Taiwan, Japan and Korea stocks, ETFs and indices, crypto and precious metals, from the same data sources as the menu bar.

Quotes the agent can use

get_quotes returns price, previous close, change %, currency, quote time and market state (pre-market, regular, after hours or closed) for the symbols you name.

Search across markets

search_symbols turns a company name or ticker into the exact market and code, so “Tencent”, “TSMC” or “Samsung” resolve without you looking anything up.

get_quotes answers from what Pulse is already refreshing for your watchlist. For a symbol you don't follow yet, the agent adds it with add_symbol and quotes it on the next refresh.

Ask in plain words.

The agent picks the tools. A few things people ask:

What are NVDA, Tesla and Tencent trading at right now? Is the US market open?
get_quotes
Find Toyota and Samsung, add them to my Asia group, and tell me how they're doing today.
search_symbolsadd_symbolget_quotes
How are my positions doing today? Which one lost the most?
list_positions
Make a group called Chips with NVDA, AMD, TSM and ASML.
create_groupsearch_symbolsadd_symbol
Here's a screenshot of my broker's trade history. Record these trades in Pulse.
record_trade
My broker says I hold 300 Tencent at an average of 382. Make Pulse match.
calibrate_position

15 tools.

Every tool works on Pulse's own data on your Mac. Read tools carry the MCP read-only hint, so your client can run them without asking and ask before any change.

Quotes and search

get_quotesRead only: The latest quotes Pulse has cached for the symbols you name.
search_symbolsRead only: Find a stock, ETF, index, crypto pair or metal by name or ticker, across markets.

Watchlists

list_watchlistsRead only: Every watchlist group with its id, name and symbols.
create_groupChanges data: Create a group. Names are unique and up to 20 characters.
rename_groupChanges data: Rename a group.
delete_groupChanges data: Delete a group. Trades and open positions are kept; the last group stays.
add_symbolChanges data: Add a symbol to a group, using the market and code from search_symbols.
remove_symbolChanges data: Remove a symbol from a group.
reorder_groupsChanges data: Set the left-to-right order of the group tabs.
reorder_symbolsChanges data: Set a group's custom order. Pinned symbols stay on top.

Positions and trades

list_positionsRead only: Holdings, average cost, realized P&L, transactions and the cached quote for every symbol with trades, closed ones included.
record_tradeChanges data: Record a buy or sell. Pass an id and a retry won't record it twice.
update_tradeChanges data: Change the side, quantity, price or date of a recorded trade.
delete_tradeChanges data: Delete a recorded trade. The position and P&L are recalculated.
calibrate_positionChanges data: Set a position to an exact quantity and average cost, for example to match your broker.

Turn it on in Pulse.

The server is off until you switch it on, and it runs only while Pulse is open.

Settings → Agents → MCP

Open the MCP settings
Click Pulse in the menu bar, open Settings, and choose MCP under Agents.
Enable the MCP server
Switch on Enable MCP Server. The status reads Running and the endpoint appears: http://127.0.0.1:41927/mcp.
Copy the token
Reveal or copy the Bearer token. You'll paste it into your client's config below in place of YOUR_PULSE_TOKEN.
Add Pulse to your client
Paste the config for your client, restart it if it asks, and ask it to list your watchlists to check.

Copy the config for your client.

Replace YOUR_PULSE_TOKEN with the token from Pulse. The endpoint is the same on every Mac.

The token is a password for your watchlists and positions. Don't commit it to a shared repository.

Claude Code

Run in Terminal. Add --scope user to use Pulse in every project.

claude mcp add --transport http pulse http://127.0.0.1:41927/mcp \
  --header "Authorization: Bearer YOUR_PULSE_TOKEN"

Claude Desktop

Settings → Developer → Edit Config. Claude Desktop reads local servers through the mcp-remote bridge, which needs Node.js.

{
  "mcpServers": {
    "pulse": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "http://127.0.0.1:41927/mcp",
        "--allow-http",
        "--header",
        "Authorization:${PULSE_AUTH}"
      ],
      "env": {
        "PULSE_AUTH": "Bearer YOUR_PULSE_TOKEN"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project.

{
  "mcpServers": {
    "pulse": {
      "url": "http://127.0.0.1:41927/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PULSE_TOKEN"
      }
    }
  }
}

Codex

Add to ~/.codex/config.toml, then start Codex.

[mcp_servers.pulse]
url = "http://127.0.0.1:41927/mcp"
http_headers = { Authorization = "Bearer YOUR_PULSE_TOKEN" }

VS Code

Add to .vscode/mcp.json in your workspace, or to your user mcp.json. Use with Copilot agent mode.

{
  "servers": {
    "pulse": {
      "type": "http",
      "url": "http://127.0.0.1:41927/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PULSE_TOKEN"
      }
    }
  }
}

Other MCP clients

Any client that speaks Streamable HTTP and can send a header.

Transport: Streamable HTTP
URL: http://127.0.0.1:41927/mcp
Header: Authorization: Bearer YOUR_PULSE_TOKEN

It stays on your Mac.

The MCP server is a door into your portfolio records, so it opens only from inside your Mac.

Localhost only

Pulse listens on 127.0.0.1:41927. Other devices on your network, and the internet, can't reach it.

Token in the Keychain

A random 256-bit token is created on first use and kept in the macOS Keychain. Every request without it is refused. Regenerate it anytime and every connected client is cut off.

Web pages are blocked

Requests from a browser page on another origin are rejected, so a website can't reach the server through your browser.

Off by default

Nothing listens until you turn the server on, and it stops when you turn it off or quit Pulse.

No trading

The tools edit Pulse's own watchlists and trade records. Pulse never places orders and has no access to your broker account.

Your data, your client

Pulse doesn't upload your watchlists or positions. What a tool returns goes to the AI client you connected, and from there to that client's model provider under its own terms.

What you need.

The MCP server is part of Pulse for Mac. It isn't a separate download or a hosted service.

Pulse for Mac on macOS 14 or later, from this website or the Mac App Store.
Pulse running, with the MCP server switched on.
An MCP client on the same Mac: Claude Code, Claude Desktop, Cursor, Codex, VS Code or another.
Node.js, only for Claude Desktop's mcp-remote bridge.

Every feature, MCP included, is free for 30 days. Then buy Pulse once for up to 3 Macs.

Download free trial Buy Pulse Mac App Store

Questions

Can I use it with ChatGPT or claude.ai in the browser?

Not directly. Those connectors run on OpenAI's and Anthropic's servers, which can't reach a server bound to 127.0.0.1 on your Mac. Use a client that runs on your Mac: Codex, Claude Code, Claude Desktop, Cursor or VS Code.

Are the quotes real time?

get_quotes returns what Pulse has already loaded for your watchlist, with the same freshness you see in the menu bar. Symbols Pulse isn't tracking return no quote: add them to a group first.

Will the agent change things without asking?

That's up to your client. Read tools are marked read-only; most clients ask before running tools that change data. Changes show up in Pulse right away.

Does it work in the Mac App Store version?

Yes. The website and Mac App Store versions have the same MCP server.

What happens when the trial ends?

The MCP server stops until you buy Pulse. Your watchlists, trades and token stay on your Mac.

The client says it can't connect.

Check that Pulse is running and Settings → Agents → MCP reads Running, that the URL is http://127.0.0.1:41927/mcp, and that the header is Authorization: Bearer followed by the current token. A regenerated token makes old configs fail with 401.

Market quotes and your watchlist,right in your AI agent.