{
  "markdown": "# ShareSeer MCP Server\n\nA 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.\n\n## 🚀 Quick Start\n\n### Get Your API Key\n\n1. Sign up at [shareseer.com/signup](https://shareseer.com/signup) (free account)\n2. Go to your [profile page](https://shareseer.com/profile)\n3. Your API key will be displayed (starts with `sk-shareseer-`)\n\n### Claude Desktop Integration\n\n**Remote MCP Server (Recommended)**\n\nAdd to your Claude Desktop configuration:\n\n**Search & Tools → Add Integrations → Add Integration URL:**\n```\nhttps://shareseer.com/mcp?api_key=YOUR_API_KEY_HERE\n```\n\nAlternatively, pass the key as a Bearer header — useful when your MCP client sets `Authorization` automatically:\n```\nAuthorization: Bearer sk-shareseer-YOUR_API_KEY_HERE\n```\n\n## 📊 Available Tools\n\n### Company Information\n- **`get_company_info`** - Get basic information about a company by ticker symbol\n- **`get_company_filings`** - Get recent SEC filings for a specific company\n- **`get_insider_transactions`** - Get insider trading transactions for a company\n\n### Market-Wide Data\n- **`get_recent_filings`** - Get recent SEC filings across all companies\n- **`get_recent_insider_activity`** - Get recent insider trading activity\n\n### Largest Transactions\n- **`get_largest_daily_transactions`** - Get largest daily insider transactions (buyers or sellers)\n- **`get_largest_weekly_transactions`** - Get largest weekly insider transactions (buyers or sellers)\n\n## 🌐 REST API\n\nA 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`.\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| GET | `/api/v1/usage` | Current rate limit usage (does not count against limits) |\n| GET | `/api/v1/search?q=berkshire` | Resolve a name, ticker, or CIK to candidates |\n| GET | `/api/v1/company?tick=NVDA` | Company info by ticker |\n| GET | `/api/v1/company/filings?tick=NVDA&limit=10` | SEC filings for a company |\n| GET | `/api/v1/company/insider-transactions?tick=NVDA&limit=10` | Insider transactions for a company |\n| GET | `/api/v1/filings/recent?limit=20` | Recent SEC filings across all companies |\n| GET | `/api/v1/insider/recent?limit=15` | Recent insider trading activity |\n| GET | `/api/v1/insider/largest/daily?type=buyers&limit=10&offset=0` | Largest daily insider transactions |\n| GET | `/api/v1/insider/largest/weekly?type=sellers&week_offset=1&limit=10` | Largest weekly insider transactions |\n\nRate 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.\n\n## 💎 Subscription Tiers\n\n| Feature | Free | Premium ($49/mo) |\n|---------|------|---------------------|\n| **Rate Limits** | 10/hour, 50/day | 100/hour, 1K/day |\n| **Filings History** | Last 24 months | Full 10-year history |\n| **Insider Data Freshness** | ~24h delay | Real-time (5-min) |\n| **Company Data** | ✅ Basic info & filings | ✅ All features |\n| **Insider Transactions** | ✅ Limited (3 results) | ✅ Unlimited |\n| **Largest Transactions** | ✅ Completed weeks only | ✅ Current week + historical |\n| **Pagination** | ❌ | ✅ |\n| **Support** | Community | Email |\n\n[**Sign Up Free**](https://shareseer.com/signup) | [**Upgrade to Premium**](https://shareseer.com/upgrade?source=mcp)\n\n## 🔧 Usage Examples\n\n### Get Company Information\nAsk Claude: *\"Tell me about NVIDIA\"*\n\n### Get Recent Insider Transactions\nAsk Claude: *\"Show me recent insider trading for Tesla\"*\n\n### Get Largest Daily Buyers\nAsk Claude: *\"Who made the biggest stock purchases today?\"*\n\n### Get Recent SEC Filings\nAsk Claude: *\"What are the most recent 10-K filings?\"*\n\n### Market Analysis\nAsk Claude: *\"Show me the largest insider selling activity this week\"*\nAsk Claude: *\"Show me the largest insider buying activity this week\"*\n\n## 🌐 Remote vs Local Setup\n\n**✅ Remote MCP (Recommended)**\n- No installation required\n- Always up-to-date\n- Hosted by ShareSeer\n- Just add the integration URL\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n**Claude Desktop doesn't show ShareSeer tools:**\n- Verify your API key is correct and active\n- Make sure the integration URL includes your API key\n- Restart Claude Desktop after adding the integration\n- Check that your ShareSeer account is active\n\n**\"Rate limit exceeded\" error:**\n- Check your current subscription tier limits\n- Wait for the rate limit window to reset\n- Consider upgrading to Premium for higher limits\n- Spread out your queries over time\n\n**\"Invalid API key\" error:**\n- Verify your API key starts with `sk-shareseer-`\n- Check that your ShareSeer account is active\n- Get a fresh API key from your profile page\n\n### Getting Help\n\n- **Free users**: [GitHub Issues](https://github.com/shareseer/mcp-server/issues)\n- **Premium users**: Email support@shareseer.com\n- **Documentation**: [ShareSeer Claude Integration](https://shareseer.com/claude-integration)\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Support\n\nLove the ShareSeer MCP server? Here's how you can help:\n\n- ⭐ **Star this repo** on GitHub\n- 🐛 **Report bugs** via GitHub Issues\n- 💡 **Request features** via GitHub Discussions\n- 📢 **Share** with other developers and traders\n- 💎 **Upgrade to Premium** to support continued development\n\n---\n\n**Built with ❤️  by the ShareSeer team**\n\n[Website](https://shareseer.com) • [X](https://x.com/shareseer) • [Email](mailto:contact@shareseer.com)\n",
  "bytes": 5674,
  "sha": "7589cef93e1e84544c04a624b86f187316042be7f6d3bf834cb873d14c189b17",
  "repo_slug": "shareseer/shareseer-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_shareseer_mcp_28d873dd/readme"
}