npm package: @solcrysai/mcp-client
Description: SolCrys AI MCP Client - Connect Claude Desktop to SolCrys AI remote MCP server
Author: SolCrys AI
Latest version: 1.0.0

# @solcrysai/mcp-client

Official SolCrys AI MCP Client for Claude Desktop. Connect to SolCrys AI's remote MCP server to access Reddit insights, competitor sentiment analysis, and more.

## Quick Start

### Prerequisites

- **Node.js** 18 or higher
- **Claude Desktop** installed
- **JWT token** from SolCrys AI (get yours at https://solcrys.ai)

### Installation

No installation required! Use `npx` to run the client directly.

### Configuration

Add this to your Claude Desktop config file:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
**Linux**: `~/.config/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "solcrys-ai": {
      "command": "npx",
      "args": ["-y", "@solcrysai/mcp-client"],
      "env": {
        "SOLCRYS_TOKEN": "your-jwt-token-here"
      }
    }
  }
}
```

That's it! Restart Claude Desktop and start using SolCrys AI tools.

## Environment Variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `SOLCRYS_TOKEN` | **Yes** | - | Your JWT authentication token |
| `SOLCRYS_SERVER_URL` | No | `https://web-copy-production-fe67.up.railway.app/mcp` | Remote MCP server URL |

## Available Tools

Once connected, you can use these tools in Claude conversations:

### `get_competitor_reddit_insights`
Get Reddit insights for competitors (Ring, Wyze, Tapo, etc.)

**Example**: "Can you get Reddit insights for Ring cameras?"

### `get_competitor_sentiment`
Analyze competitor sentiment from news and Reddit

**Example**: "What's the sentiment around Wyze products?"

### `get_reddit_topics`
Get trending topics for a brand from Reddit

**Example**: "What are people discussing about Tapo on Reddit?"

## Rate Limits

Your subscription tier determines your rate limits:

- **Free Tier**: 100 requests per 15 minutes
- **Pro Tier**: 500 requests per 15 minutes
- **Enterprise Tier**: 1000 requests per 15 minutes

## Troubleshooting

### Connection Failed

1. **Check your token**: Ensure `SOLCRYS_TOKEN` is valid and not expired
2. **Node.js version**: Run `node --version` (must be v18+)
3. **Internet connection**: Verify you can reach https://web-copy-production-fe67.up.railway.app
4. **Claude Desktop logs**: View → Developer → Toggle Developer Tools → Console

### Common Errors

**"Invalid or expired token"**
- Your JWT token has expired or is invalid
- Contact support@solcrys.ai for a new token

**"Command not found: npx"**
- Node.js is not installed properly
- Install from https://nodejs.org

**"Rate limit exceeded"**
- You've exceeded your tier's rate limit
- Wait 15 minutes or upgrade your tier

## Support

- **Documentation**: https://docs.solcrys.ai
- **Email**: support@solcrys.ai
- **Issues**: https://github.com/solcrys/mcp-client/issues

## Security

- ✅ Uses secure HTTPS connections
- ✅ JWT token authentication
- ✅ Rate limiting per tier
- ❌ Never share your token publicly

## License

MIT © SolCrys AI

---

**Version**: 1.0.0
**Last Updated**: January 2025