Rice Stock Data 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

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

Step 2: Configure Claude Desktop

1. Open Claude Desktop
2. Go to Settings → Developer → Edit Config
3. 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"
      }
    }
  }
}

4. Replace "your_actual_access_token_here" with your actual access token from Step 1 (keep the quotation marks)
5. Save the configuration file
6. 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