Skip to main content
Glama
Sharesight MCP Server

Sharesight MCP Server

by Haizzz

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:

Step 2: Run One-Time Authentication

npx github:Haizzz/sharesight-mcp auth

The CLI will:

  1. Prompt for your Client ID and Client Secret

  2. Display a URL to open in your browser

  3. Ask you to log in to Sharesight and authorize the app

  4. Prompt you to paste the authorization code

  5. 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_portfolios

List all user portfolios with optional consolidated view

get_portfolio

Get detailed portfolio information by ID

list_portfolio_holdings

List all holdings within a specific portfolio

get_portfolio_user_setting

Get user display preferences for a portfolio

update_portfolio_user_setting

Update chart type, grouping, and other display settings

Holdings Management

Tool

Description

list_holdings

List all holdings across all portfolios

get_holding

Get holding details with optional cost base and historical values

update_holding

Update holding settings (DRP configuration)

delete_holding

Remove a holding from a portfolio

Custom Investments

Tool

Description

list_custom_investments

List custom/unlisted investments

get_custom_investment

Get custom investment details

create_custom_investment

Create a new custom investment (property, bonds, etc.)

update_custom_investment

Update custom investment properties

delete_custom_investment

Remove a custom investment

Custom Investment Prices

Tool

Description

list_custom_investment_prices

Get price history for a custom investment

create_custom_investment_price

Add a new price entry

update_custom_investment_price

Modify an existing price entry

delete_custom_investment_price

Remove a price entry

Coupon Rates (Fixed Interest)

Tool

Description

list_coupon_rates

List interest rates for fixed interest investments

create_coupon_rate

Add a new coupon rate

update_coupon_rate

Modify a coupon rate

delete_coupon_rate

Remove a coupon rate

Performance Reports

Tool

Description

get_performance_report

Detailed performance breakdown with gains analysis

get_performance_index_chart

Chart data for visualizing portfolio performance

Other

Tool

Description

list_countries

Get Sharesight-supported countries and their settings

show_coupon_code

View applied promotional coupon code

apply_coupon_code

Apply a promotional coupon code

delete_coupon_code

Remove applied coupon code

revoke_api_access

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 build

Then 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.json

  • Windows: %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 server

License

MIT

Support

Available Tools

29 tools
apply_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

    B3/5.0

    Scored across 29 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      23
      2
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to Kuvera mutual fund portfolios, enabling real-time queries about holdings, performance, and fund details.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to read and query a Finanze self-hosted portfolio manager using natural language, including net worth, positions, and financial calculations.
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Provides read-only access to Robinhood portfolio data, enabling AI assistants to perform portfolio analysis, research, and comparison through natural language queries.
      16
      MIT