Back to the catalog

ShareSEER

Access SEC filings, insider transactions, and financial data via the ShareSEER API.

Open source Repository Open in the app JSON README (API)

About

Access SEC filings, insider transactions, and financial data via the ShareSEER API.

Details

Kind
MCP servers
Topic
Finance & crypto
Publisher
com.shareseer
Origin
official
Category
ferramentas
Transport
http
Version
0.1.0
Stars
9
Forks
5
Open pull requests
1
Last push
2026-08-07T15:59:11Z
Repository state
ativo
License
MIT
Added
2026-08-29 03:01:22
Updated
2026-09-12 16:04:06
Origin id
com.shareseer/mcp

README

# 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

### Get Your API Key

1. Sign up at [shareseer.com/signup](https://shareseer.com/signup) (free account)
2. Go to your [profile page](https://shareseer.com/profile)
3. Your API key will be displayed (starts with `sk-shareseer-`)

### Claude Desktop Integration

**Remote MCP Server (Recommended)**

Add to your Claude Desktop configuration:

**Search & Tools โ†’ Add Integrations โ†’ Add Integration URL:**
```
https://shareseer.com/mcp?api_key=YOUR_API_KEY_HERE
```

Alternatively, pass the key as a Bearer header โ€” useful when your MCP client sets `Authorization` automatically:
```
Authorization: Bearer sk-shareseer-YOUR_API_KEY_HERE
```

## ๐Ÿ“Š 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 by passing `?api_key=YOUR_KEY` or `Authorization: Bearer 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
- Just add the integration URL

## ๐Ÿ› Troubleshooting

### Common Issues

**Claude Desktop doesn't show ShareSeer tools:**
- Verify your API key is correct and active
- Make sure the integration URL includes your API key
- Restart Claude Desktop after adding the integration
- Check that your ShareSeer account is active

**"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/mcp-server/issues)
- **Premium users**: Email support@shareseer.com
- **Documentation**: [ShareSeer Claude Integration](https://shareseer.com/claude-integration)

## ๐Ÿ“„ 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)

More