Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@kerryback/rice-stock-data) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Rice Stock Data MCP Server

A Model Context Protocol (MCP) server for accessing Rice Business Stock Market Data Portal through Claude Desktop.

Features

Natural language queries for stock market data
Access to comprehensive financial metrics and indicators
Rice University email verification for access control
Seamless integration with Claude Desktop

Prerequisites

You must have Node.js installed on your computer to use this MCP server.

Download Node.js: Visit nodejs.org and install the LTS version
Verify installation: Open terminal/command prompt and run:
```
node --version
npm --version
```
Both commands should return version numbers.

Claude Desktop Configuration

Step 1: Get Your Access Token

Visit the Rice Business Stock Market Data Portal
Verify your Rice University email address
Copy your personal access token

Step 2: Configure Claude Desktop

Open Claude Desktop
Go to Settings → Developer → Edit Config
Add the following configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "rice-stock-data": {
      "command": "npx",
      "args": ["@kerryback/rice-stock-data"],
      "env": {
        "USER_ACCESS_TOKEN": "your_actual_access_token_here",
        "APP_URL": "https://your-actual-data-portal.rice-business.org"
      }
    }
  }
}

Replace "your_actual_access_token_here" with your actual access token from Step 1 (keep the quotation marks)
Save the configuration file
Restart Claude Desktop

Step 3: Using the MCP Server

Once configured, you can ask Claude questions about stock market data:

"Show me tech stocks with PE under 20"
"What are Apple's financial ratios?"
"List healthcare companies by market cap"
"Get the latest earnings data for Microsoft"
"Compare revenue growth across FAANG stocks"

Local Development

Installation

npm install
npm run build

Running the MCP Server Locally

npm run start:mcp

Running the Web Server (for deployment)

npm start

Environment Variables

USER_ACCESS_TOKEN - Your personal Rice Data Portal access token (required)
APP_URL - Data portal base URL (default: https://data-portal-mcp.rice-business.org)
PORT - Web server port (default: 8000, used for deployment only)

API Endpoints

The web server provides these endpoints (for deployment):

GET / - Server information
GET /health - Health check endpoint
POST /chat - Query endpoint (requires token in request body)

Troubleshooting

"Authentication failed" error

Verify your access token is correct and hasn't expired
Ensure you've verified your Rice University email

"Rate limit exceeded" error

Wait a moment before making additional queries
The API has rate limiting to ensure fair usage

Claude Desktop doesn't show the MCP server

Make sure you've restarted Claude Desktop after configuration
Check that the configuration JSON is valid (no syntax errors)
Verify the package name is correct: @kerryback/rice-stock-data

Support

For issues or questions about:

MCP Server: Open an issue in this repository
Data Portal Access: Contact Rice Business IT support
Stock Data: Refer to the Rice Business Stock Market Data Portal documentation

License

MIT