Sharesight MCP Server
The Sharesight MCP Server enables AI assistants to interact with Sharesight portfolio tracking data through 27 tools covering portfolio management, holdings, custom investments, performance analysis, and account settings.
Portfolio Management: List all portfolios with optional filtering or consolidation, get detailed portfolio information, view holdings within portfolios, and manage user display preferences (chart types, grouping, inclusion of sold shares).
Holdings Management: List all holdings across portfolios, retrieve detailed holding information with options for cost base, average purchase price, or historical values, update Dividend Reinvestment Plan (DRP) settings, and delete holdings.
Custom Investments: Create, read, update, and delete custom/unlisted investments (property, bonds, managed funds, etc.) with support for various investment types including ordinary shares and fixed interest instruments. Manage price history with date-specific pricing entries and handle coupon rates for fixed interest investments with full CRUD operations.
Performance Analysis: Generate detailed performance reports with gains analysis, holdings breakdown, and benchmarks. Retrieve performance index chart data for visualizing portfolio performance over time. Filter and group data by date ranges, country, currency, market, sector, industry, or custom groups.
Account Management: List supported countries and their settings, view, apply, and remove promotional coupon codes, and revoke API access to invalidate all associated tokens.
Authentication: Uses OAuth 2.0 with automatic token refresh and secure local token storage.
Sharesight MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with access to the Sharesight portfolio tracking platform via the v3 API.
Quick Start
Step 1: Get OAuth Credentials
You'll need a Client ID and Client Secret from Sharesight to use this server.
How to get credentials:
Contact Sharesight support at support@sharesight.com to request API access
Visit the Sharesight API documentation for more information
API access may require a specific Sharesight plan
Step 2: Run One-Time Authentication
npx github:Haizzz/sharesight-mcp authThe CLI will:
Prompt for your Client ID and Client Secret
Display a URL to open in your browser
Ask you to log in to Sharesight and authorize the app
Prompt you to paste the authorization code
Save tokens locally (they refresh automatically)
Step 3: Add MCP Server Configuration
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sharesight": {
"command": "npx",
"args": ["-y", "github:Haizzz/sharesight-mcp", "serve"],
"env": {
"SHARESIGHT_CLIENT_ID": "your_client_id",
"SHARESIGHT_CLIENT_SECRET": "your_client_secret"
}
}
}
}Restart Claude Desktop and you're ready to go!
Related MCP server: Kuvera MCP
Overview
This MCP server enables Claude and other AI assistants to interact with Sharesight accounts, allowing natural language queries and operations on investment portfolios, holdings, custom investments, and performance reports.
What is Sharesight?
Sharesight is a portfolio tracking platform that helps investors track their stocks, ETFs, mutual funds, and other investments across multiple markets. It provides performance reporting, dividend tracking, and tax reporting features.
What is MCP?
The Model Context Protocol is an open standard that enables AI assistants to securely connect to external data sources and tools.
Features
This server exposes 27 tools covering all Sharesight v3 API endpoints:
Portfolio Management
Tool | Description |
| List all user portfolios with optional consolidated view |
| Get detailed portfolio information by ID |
| List all holdings within a specific portfolio |
| Get user display preferences for a portfolio |
| Update chart type, grouping, and other display settings |
Holdings Management
Tool | Description |
| List all holdings across all portfolios |
| Get holding details with optional cost base and historical values |
| Update holding settings (DRP configuration) |
| Remove a holding from a portfolio |
Custom Investments
Tool | Description |
| List custom/unlisted investments |
| Get custom investment details |
| Create a new custom investment (property, bonds, etc.) |
| Update custom investment properties |
| Remove a custom investment |
Custom Investment Prices
Tool | Description |
| Get price history for a custom investment |
| Add a new price entry |
| Modify an existing price entry |
| Remove a price entry |
Coupon Rates (Fixed Interest)
Tool | Description |
| List interest rates for fixed interest investments |
| Add a new coupon rate |
| Modify a coupon rate |
| Remove a coupon rate |
Performance Reports
Tool | Description |
| Detailed performance breakdown with gains analysis |
| Chart data for visualizing portfolio performance |
Other
Tool | Description |
| Get Sharesight-supported countries and their settings |
| View applied promotional coupon code |
| Apply a promotional coupon code |
| Remove applied coupon code |
| Disconnect API access (invalidates all tokens) |
Install from Source
git clone https://github.com/Haizzz/sharesight-mcp.git
cd sharesight-mcp
npm install
npm run buildThen run auth and configure:
node dist/index.js auth{
"mcpServers": {
"sharesight": {
"command": "node",
"args": ["/path/to/sharesight-mcp/dist/index.js", "serve"],
"env": {
"SHARESIGHT_CLIENT_ID": "your_client_id",
"SHARESIGHT_CLIENT_SECRET": "your_client_secret"
}
}
}
}Token Storage
OAuth tokens are stored at:
Linux/macOS:
~/.sharesight-mcp/tokens.jsonWindows:
%USERPROFILE%\.sharesight-mcp\tokens.json
Tokens refresh automatically. To re-authorize, delete the tokens file and run sharesight-mcp auth again.
Error Handling
Common errors:
401 - Invalid or expired access token
403 - Token revoked or insufficient permissions
404 - Resource not found
422 - Validation error (check field values)
Development
npm run dev # Watch mode
npm run build # Build for production
npm start # Run the serverLicense
MIT
Support
Sharesight Support: support@sharesight.com
API Documentation: https://api.sharesight.com/doc/api/v3
MCP Protocol: https://modelcontextprotocol.io/
Available Tools
29 toolsapply_coupon_codeC
Applies a coupon code to the current user
Inputs: code (required).
create_coupon_rateC
Creates a coupon rate for a custom investment
Inputs: instrument_id (required), interest_rate (required), date (required).
create_custom_investmentC
Creates a new custom investment
Inputs: code (required), name (required), country_code (required), investment_type (required), +8 more.
create_custom_investment_priceC
Creates a price entry for a custom investment
Inputs: custom_investment_id (required), last_traded_price (required), last_traded_on (required).
delete_coupon_codeB
Removes the coupon code from the current user
Inputs: no named parameters.
delete_coupon_rateC
Deletes a coupon rate
Inputs: id (required).
delete_custom_investmentC
Deletes a custom investment
Inputs: id (required).
delete_custom_investment_priceC
Deletes a price for a custom investment
Inputs: price_id (required).
delete_holdingC
Deletes a holding
Inputs: holding_id (required).
get_custom_investmentC
Retrieves a single custom investment by ID
Inputs: id (required).
get_holdingC
Retrieves details of a specific holding
Inputs: holding_id (required), average_purchase_price, cost_base, values_over_time.
get_performance_index_chartB
Returns performance index chart data points for visualizing portfolio performance over time
Inputs: portfolio_id (required), consolidated, start_date, end_date, +3 more.
get_performance_reportC
Retrieves the performance report for a portfolio with gains, holdings breakdown, and benchmarks
Inputs: portfolio_id (required), start_date, end_date, consolidated, +6 more.
get_portfolioC
Retrieves a single portfolio by ID
Inputs: portfolio_id (required), consolidated.
get_portfolio_user_settingC
Retrieves user settings for a portfolio (chart type, grouping, etc.)
Inputs: portfolio_id (required), consolidated.
list_countriesC
Retrieves Sharesight country definitions
Inputs: supported.
list_coupon_ratesC
Retrieves coupon rates for a fixed interest custom investment
Inputs: instrument_id (required), start_date, end_date, page, +1 more.
list_custom_investment_pricesC
Retrieves prices for a custom investment
Inputs: custom_investment_id (required), start_date, end_date, page, +1 more.
list_custom_investmentsC
Retrieves a list of custom investments
Inputs: portfolio_id.
list_holdingsB
Retrieves a list of all holdings across all portfolios
Inputs: no named parameters.
list_portfolio_holdingsC
Retrieves all holdings for a specific portfolio
Inputs: portfolio_id (required), consolidated.
list_portfoliosB
Retrieves a list of the user's portfolios. Optionally filter by consolidated view or instrument.
Inputs: consolidated, instrument_id.
revoke_api_accessB
Disconnects API access for the user. Invalidates ALL access and refresh tokens.
Inputs: client_id (required).
show_coupon_codeB
Returns the coupon code applied to the current user
Inputs: no named parameters.
update_coupon_rateC
Updates a coupon rate
Inputs: id (required), interest_rate (required), date (required).
update_custom_investmentC
Updates an existing custom investment
Inputs: id (required), code, name, portfolio_id, +7 more.
update_custom_investment_priceC
Updates a price for a custom investment
Inputs: price_id (required), last_traded_price, last_traded_on.
update_holdingC
Updates a holding (currently supports DRP settings)
Inputs: holding_id (required), enable_drp, drp_mode_setting.
update_portfolio_user_settingC
Updates user settings for a portfolio
Inputs: portfolio_id (required), consolidated, portfolio_chart, holding_chart, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 29 tools
Most tools have distinct purposes targeting specific resources and actions, such as custom investments, coupon rates, holdings, and portfolios. However, there is some potential overlap between 'list_holdings' (all holdings across portfolios) and 'list_portfolio_holdings' (holdings for a specific portfolio), which could cause minor confusion in selection. Overall, the descriptions help clarify boundaries, keeping ambiguity low.
Tool names follow a highly consistent verb_noun pattern throughout, such as 'create_custom_investment', 'list_coupon_rates', and 'update_holding'. All tools use snake_case with clear action verbs (e.g., apply, create, delete, get, list, update, show, revoke), making them predictable and easy to understand. No deviations or mixed conventions are present.
With 29 tools, the count is borderline high for a portfolio management server, potentially feeling heavy and overwhelming. While the tools cover various aspects like custom investments, coupon codes, holdings, and portfolios, the number might exceed typical well-scoped ranges (3-15 tools), suggesting some consolidation or simplification could improve usability without losing functionality.
The tool set provides comprehensive CRUD and lifecycle coverage for the domain of portfolio and investment management. It includes operations for custom investments, coupon rates, holdings, portfolios, performance data, and user settings, with no obvious gaps. Agents can perform full workflows from creation to deletion and reporting, ensuring no dead ends in typical use cases.
Maintenance
Related MCP Connectors
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Connect your portfolio to Claude, ChatGPT, or Codex to analyze it and make smarter investments.
Read-only access to your own crypto portfolio across 11+ exchanges and 20+ chains: holdings, full history, FIFO cost basis and P&L, fees and income. Ask Claude or ChatGPT about your portfolio; the connector can never trade, move funds or act as a login.
Connect AI agents to bank accounts, transactions, balances, and investments.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Trading 212 investment accounts for portfolio tracking, account management, and real-time order execution. It supports managing investment pies, analyzing historical data, and monitoring market performance across multiple instrument types.232MIT
- FlicenseNot gradedqualityDmaintenanceConnects AI assistants to Kuvera mutual fund portfolios, enabling real-time queries about holdings, performance, and fund details.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to read and query a Finanze self-hosted portfolio manager using natural language, including net worth, positions, and financial calculations.MIT
- AlicenseBqualityCmaintenanceProvides read-only access to Robinhood portfolio data, enabling AI assistants to perform portfolio analysis, research, and comparison through natural language queries.16MIT