shareseer-mcp-server

# ShareSeer MCP Server

A Model Context Protocol (MCP) server that provides access to ShareSeer's comprehensive SEC filings, insider transactions, and financial data through Claude and other MCP-compatible AI assistants.

## 🚀 Quick Start

### Claude (web, desktop, or mobile)

No API key needed — you sign in with your ShareSeer account.

1. Go to **Settings → Connectors → Add custom connector**.
2. Enter the server URL `https://shareseer.com/mcp` and click **Continue**.
3. Claude detects **Sign in now** — leave it selected and click **Add**.
4. Click **Connect** and approve the request.

Claude receives a token scoped to your account that refreshes on its own. You can disconnect at
any time without affecting your API key.

If you don't have a ShareSeer account yet, sign up free at
[shareseer.com/signup](https://shareseer.com/signup) — you'll be prompted to sign in during step 4.

### Claude Code and other MCP clients

Clients that prefer a static credential can pass your API key as a header instead. Get the key
from your [profile page](https://shareseer.com/profile) (it starts with `sk-shareseer-`).

```
claude mcp add --transport http shareseer https://shareseer.com/mcp \
  --header "Authorization: Bearer sk-shareseer-YOUR_API_KEY_HERE"
```

Or in your project's `.mcp.json`:

```json
{
  "mcpServers": {
    "shareseer": {
      "type": "http",
      "url": "https://shareseer.com/mcp",
      "headers": {
        "Authorization": "Bearer sk-shareseer-YOUR_API_KEY_HERE"
      }
    }
  }
}
```

The server accepts `authorization`, `x-api-key`, `api-key`, and `x-auth-token`, so whichever header
name your client offers will work. An `Authorization` value must include the `Bearer ` prefix;
`x-api-key` takes the bare key.

## 📊 Available Tools

### Company Information
- **`get_company_info`** - Get basic information about a company by ticker symbol
- **`get_company_filings`** - Get recent SEC filings for a specific company
- **`get_insider_transactions`** - Get insider trading transactions for a company

### Market-Wide Data
- **`get_recent_filings`** - Get recent SEC filings across all companies
- **`get_recent_insider_activity`** - Get recent insider trading activity

### Largest Transactions
- **`get_largest_daily_transactions`** - Get largest daily insider transactions (buyers or sellers)
- **`get_largest_weekly_transactions`** - Get largest weekly insider transactions (buyers or sellers)

## 🌐 REST API

A REST API is available at `https://shareseer.com/api/v1` for programmatic access. Authenticate with `X-API-Key: YOUR_KEY`, `Authorization: Bearer YOUR_KEY`, or `?api_key=YOUR_KEY`.

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `/api/v1/usage` | Current rate limit usage (does not count against limits) |
| GET | `/api/v1/search?q=berkshire` | Resolve a name, ticker, or CIK to candidates |
| GET | `/api/v1/company?tick=NVDA` | Company info by ticker |
| GET | `/api/v1/company/filings?tick=NVDA&limit=10` | SEC filings for a company |
| GET | `/api/v1/company/insider-transactions?tick=NVDA&limit=10` | Insider transactions for a company |
| GET | `/api/v1/filings/recent?limit=20` | Recent SEC filings across all companies |
| GET | `/api/v1/insider/recent?limit=15` | Recent insider trading activity |
| GET | `/api/v1/insider/largest/daily?type=buyers&limit=10&offset=0` | Largest daily insider transactions |
| GET | `/api/v1/insider/largest/weekly?type=sellers&week_offset=1&limit=10` | Largest weekly insider transactions |

Rate limit headers (`X-RateLimit-Limit-Hourly`, `X-RateLimit-Remaining-Hourly`, etc.) are returned on every request. The `/api/v1/usage` endpoint returns a JSON breakdown without consuming a request.

## 💎 Subscription Tiers

| Feature | Free | Premium ($49/mo) |
|---------|------|---------------------|
| **Rate Limits** | 10/hour, 50/day | 100/hour, 1K/day |
| **Filings History** | Last 24 months | Full 10-year history |
| **Insider Data Freshness** | ~24h delay | Real-time (5-min) |
| **Company Data** | ✅ Basic info & filings | ✅ All features |
| **Insider Transactions** | ✅ Limited (3 results) | ✅ Unlimited |
| **Largest Transactions** | ✅ Completed weeks only | ✅ Current week + historical |
| **Pagination** | ❌ | ✅ |
| **Support** | Community | Email |

[**Sign Up Free**](https://shareseer.com/signup) | [**Upgrade to Premium**](https://shareseer.com/upgrade?source=mcp)

## 🔧 Usage Examples

### Get Company Information
Ask Claude: *"Tell me about NVIDIA"*

### Get Recent Insider Transactions
Ask Claude: *"Show me recent insider trading for Tesla"*

### Get Largest Daily Buyers
Ask Claude: *"Who made the biggest stock purchases today?"*

### Get Recent SEC Filings
Ask Claude: *"What are the most recent 10-K filings?"*

### Market Analysis
Ask Claude: *"Show me the largest insider selling activity this week"*
Ask Claude: *"Show me the largest insider buying activity this week"*

## 🌐 Remote vs Local Setup

**✅ Remote MCP (Recommended)**
- No installation required
- Always up-to-date
- Hosted by ShareSeer
- Sign in once and you're done

## 🐛 Troubleshooting

### Common Issues

**Claude doesn't show ShareSeer tools:**
- Make sure you completed the **Connect** step — adding the connector alone doesn't sign you in
- Restart Claude after adding the connector
- Check that your ShareSeer account is active

**Using a header instead of signing in, and calls fail:**
- If you used `authorization`, the value must start with `Bearer ` (including the space);
  `x-api-key` takes the bare key
- Verify your API key is correct and active on your [profile page](https://shareseer.com/profile)

**"Rate limit exceeded" error:**
- Check your current subscription tier limits
- Wait for the rate limit window to reset
- Consider upgrading to Premium for higher limits
- Spread out your queries over time

**"Invalid API key" error:**
- Verify your API key starts with `sk-shareseer-`
- Check that your ShareSeer account is active
- Get a fresh API key from your profile page

### Getting Help

- **Free users**: [GitHub Issues](https://github.com/shareseer/shareseer-mcp-server/issues)
- **Premium users**: Email support@shareseer.com
- **Documentation**: [ShareSeer MCP docs](https://shareseer.com/docs/mcp)

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Support

Love the ShareSeer MCP server? Here's how you can help:

- ⭐ **Star this repo** on GitHub
- 🐛 **Report bugs** via GitHub Issues
- 💡 **Request features** via GitHub Discussions
- 📢 **Share** with other developers and traders
- 💎 **Upgrade to Premium** to support continued development

---

**Built with ❤️  by the ShareSeer team**

[Website](https://shareseer.com) • [X](https://x.com/shareseer) • [Email](mailto:contact@shareseer.com)