{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/logo.png\" alt=\"Profitelligence\" width=\"200\" />\n</p>\n\n<h1 align=\"center\">Profitelligence MCP Server</h1>\n\n<p align=\"center\">\n\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![MCP Protocol](https://img.shields.io/badge/MCP-Compatible-purple.svg)](https://modelcontextprotocol.io)\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-listed-blue.svg)](https://registry.modelcontextprotocol.io/v0/servers?search=profitelligence)\n\n**Financial intelligence for AI agents.** Give Claude access to insider trading data, SEC filings, economic indicators, and multi-signal analysis — all through a single MCP server.\n\n[Get Started Free](https://profitelligence.com) · [View Pricing](https://profitelligence.com/pricing)\n\n---\n\n## Why Profitelligence?\n\nTraditional financial APIs return mountains of raw data. Your AI agent burns through tokens parsing CSVs, making repeated calls, and piecing together context. **Profitelligence is different.**\n\nWe provide **semantically dense, LLM-optimized responses** designed for AI agents:\n\n| Traditional MCP Servers | Profitelligence MCP |\n|------------------------|---------------------|\n| Many narrow tools (10-20+) | **7 powerful tools** with rich filtering |\n| Raw data dumps | **Pre-contextualized intelligence** |\n| Multiple calls to answer one question | **One call, complete answer** |\n| Token-heavy responses | **Optimized for token efficiency** |\n| Complex tool orchestration | **Agent has full control** |\n\n### What You Get\n\n- **Insider Trading Intelligence** — Form 4 filings with entity search (\"find Warren Buffett's trades\")\n- **SEC Filing Analysis** — AI-summarized 8-K events with impact scoring\n- **Market Data** — Company profiles, OHLC prices, sector/industry context\n- **Economic Indicators** — Federal Reserve (FRED) data for macro context\n- **Multi-Signal Analysis** — Opportunity scoring that combines insider activity + SEC events + price action (PRO)\n\n### Safe by Design\n\nThis MCP server is a **thin, stateless layer** over Profitelligence's REST APIs:\n\n- ✅ **Read-only** — No ability to modify your account or execute trades\n- ✅ **No data storage** — Responses flow through, nothing is cached locally\n- ✅ **Documented** — Every tool, argument, and response format is specified in this repo\n- ✅ **Your API key** — You control access; revoke anytime from your dashboard\n\n---\n\n## Quick Start\n\n### Option A: Connect via MCP Directory (Recommended)\n\nThe easiest way to get started:\n\n1. Visit the [Anthropic MCP Directory](https://claude.ai/connectors)\n2. Find and click **Profitelligence**\n3. Complete OAuth authentication with your Google account\n4. Start asking financial questions!\n\nNo API key needed — authentication is handled automatically.\n\n---\n\n### Option B: Manual Setup with API Key\n\n#### 1. Create a Free Account\n\nSign up at **[profitelligence.com](https://profitelligence.com)** — no credit card required.\n\nThe free tier includes:\n- Access to top 500 stocks by volume\n- Insider trading data (Form 4)\n- SEC 8-K filing summaries\n- Economic indicators (FRED)\n- 250 API calls/day\n\n#### 2. Get Your API Key\n\nGenerate an API key from your [account dashboard](https://profitelligence.com/account/api-keys).\n\n#### 3. Add to Claude\n\n**Claude Desktop (easiest):**\n\nGo to **Settings → Connectors → Add Custom Connector** and paste this URL:\n\n```\nhttps://mcp.profitelligence.com/mcp?apiKey=YOUR_API_KEY\n```\n\nReplace `YOUR_API_KEY` with your key (e.g. `pk_live_abc123...`). That's it — start chatting.\n\n**Claude Desktop (config file alternative):**\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n```json\n{\n  \"mcpServers\": {\n    \"profitelligence\": {\n      \"url\": \"https://mcp.profitelligence.com/mcp?apiKey=YOUR_API_KEY\",\n      \"transport\": \"streamable-http\"\n    }\n  }\n}\n```\n\n**Claude Code (one-liner):**\n```bash\nclaude mcp add profitelligence --transport http \\\n  https://mcp.profitelligence.com/mcp \\\n  --header \"X-API-Key: YOUR_API_KEY\"\n```\n\nThat's it! Ask Claude: *\"What insider buying happened in tech stocks this week?\"*\n\n---\n\n## Pricing & Tiers\n\n| Feature | Free | PRO ($4.99/mo) | Elite ($9.99/mo) |\n|---------|------|----------------|------------------|\n| Stock coverage | Top 500 | Top 6,000 | All stocks |\n| API calls | 250/day | 1,000/day | 10,000/day |\n| Insider trading (Form 4) | ✅ | ✅ | ✅ |\n| SEC 8-K summaries | ✅ | ✅ | ✅ |\n| Economic indicators | ✅ | ✅ | ✅ |\n| Opportunity scoring | — | ✅ | ✅ |\n| Multi-signal analysis | — | ✅ | ✅ |\n| Alert subscriptions | — | 10 alerts | Unlimited |\n| Priority support | — | — | ✅ |\n\n**Early adopter pricing** — $4.99/mo PRO and $9.99/mo Elite rates are locked in for the first 1,000 users (regular: $10/mo and $29/mo). [Upgrade anytime](https://profitelligence.com/pricing).\n\n---\n\n## Available Tools\n\n7 tools designed for maximum token efficiency. Each answers complete questions with rich, contextual responses:\n\n| Tool | Purpose | Example Query |\n|------|---------|---------------|\n| `pulse()` | Market snapshot | \"What's happening in the market right now?\" |\n| `investigate(subject)` | Deep research | \"Tell me about NVDA's insider activity\" |\n| `screen(focus)` | Opportunity scanning | \"Find tech stocks with insider buying\" |\n| `assess(symbol)` | Position health check | \"How is my AAPL position doing?\" |\n| `institutional(query_type)` | 13F intelligence | \"What is Berkshire buying?\" |\n| `search(q)` | Semantic search | \"Find CEO resignation filings\" |\n| `service_info()` | Account & service info | \"What's my subscription tier?\" |\n\n---\n\n## Usage Examples\n\n### Example 1: Get Market Overview\n**User prompt:** \"What's happening in the market right now?\"\n\n**What happens:**\n- Server calls `pulse()` tool\n- Returns current market movers (gainers, losers, volume leaders)\n- Shows recent high-impact SEC 8-K filings with AI-generated summaries\n- Lists notable insider transactions from Form 4 filings\n- Provides key economic indicators from FRED\n\n### Example 2: Research a Company\n**User prompt:** \"Tell me about NVIDIA's insider activity and recent filings\"\n\n**What happens:**\n- Server calls `investigate(\"NVDA\")` tool\n- Returns company profile with sector, market cap, and CEO\n- Shows price history and technical signals\n- Lists recent 8-K material events with impact scores\n- Provides Form 4 insider transaction summary and sentiment\n- Includes latest financials from 10-K/10-Q filings\n\n### Example 3: Find Investment Opportunities\n**User prompt:** \"Find tech stocks where insiders are buying\"\n\n**What happens:**\n- Server calls `screen(focus=\"insider\", sector=\"Technology\")` tool\n- Scans market for insider buying clusters in Technology sector\n- Returns ranked list of opportunities with transaction details\n- Shows insider names, roles, and transaction values\n- Provides opportunity scores based on multi-signal analysis\n\n### Example 4: Track Institutional Investors\n**User prompt:** \"What is Berkshire Hathaway buying?\"\n\n**What happens:**\n- Server calls `institutional(\"manager\", identifier=\"Berkshire\")` tool\n- Uses fuzzy search to find matching institutional manager\n- Returns top holdings from latest 13F filing\n- Shows recent position changes (new buys, additions, exits)\n- Lists high-conviction positions (5%+ of portfolio)\n\n---\n\n## Tool Reference\n\nUnderstanding **when** to use each tool is key to getting the best results. Here's the mental model:\n\n### `pulse()` — What's happening right now?\n\n**Use when:** User wants a market overview without a specific company in mind.\n\n**Returns:** Market movers, recent high-impact 8-K filings, notable insider trades, key economic indicators.\n\n**No parameters.** Just call it.\n\n```\npulse()\n```\n\n**Best for:** Starting a session, getting oriented, \"what should I look at today?\"\n\n---\n\n### `investigate(subject)` — Deep dive on a specific entity\n\n**Use when:** User names a specific company, insider, or sector they want to research.\n\n**Auto-detects entity type:**\n- Stock symbols (`AAPL`, `NVDA`) → Company research\n- CIK numbers (`0001067983`) → Insider research\n- Sector names (`Technology`) → Sector analysis\n\n**Returns for companies:**\n- Profile, price history, material events (8-K filings)\n- Insider intelligence (Form 4 summary + recent transactions)\n- Financials (income statement, balance sheet, cash flow from 10-K/10-Q)\n- Opportunity signals, technical indicators\n\n```\ninvestigate(\"AAPL\")                           # Company\ninvestigate(\"0001067983\")                     # Warren Buffett by CIK\ninvestigate(\"Technology\", entity_type=\"sector\")  # Sector\n```\n\n**Best for:** \"Tell me about X\", \"What's going on with X?\", research before a decision.\n\n---\n\n### `screen(focus)` — Find opportunities across the market\n\n**Use when:** User wants to discover stocks matching certain criteria, not research a specific one.\n\n**Parameters:**\n- `focus`: What signal to screen for\n  - `\"all\"` — Everything (default)\n  - `\"multi_signal\"` — Stocks with multiple confirming signals\n  - `\"insider\"` — Insider buying clusters\n  - `\"events\"` — High-impact 8-K filings\n- `sector`: Filter to a sector (e.g., `\"Technology\"`)\n- `min_score`: Minimum opportunity score (0-100)\n- `days`: Lookback period (default 7)\n- `limit`: Max results (default 25)\n\n```\nscreen()                                    # Everything\nscreen(focus=\"insider\", sector=\"Technology\") # Tech insider buying\nscreen(focus=\"events\", days=14)             # Recent material events\n```\n\n**Best for:** \"What opportunities are out there?\", \"Find me stocks where insiders are buying.\"\n\n---\n\n### `assess(symbol)` — Health check for a position you own\n\n**Use when:** User owns a stock and wants to evaluate whether to hold, add, or sell.\n\n**Returns:**\n- Current price action and technical signals\n- Recent material events (8-K filings)\n- Insider sentiment (are insiders buying or selling?)\n- Institutional sentiment (13F accumulation/distribution)\n- Financials snapshot\n- Risk factors\n\n```\nassess(\"NVDA\")\nassess(\"AAPL\", days=90)  # Longer lookback\n```\n\n**Best for:** Portfolio review, \"How's my position in X?\", \"Should I be worried about X?\"\n\n---\n\n### `institutional(query_type)` — 13F institutional investor intelligence\n\n**Use when:** User wants to know what big money is doing.\n\n**Query types:**\n- `\"manager\"` — Profile a specific fund (by name or CIK)\n- `\"security\"` — Who owns a specific stock?\n- `\"signal\"` — Find stocks with institutional flow patterns\n\n**Signal types** (for `query_type=\"signal\"`):\n- `\"accumulation\"` — Stocks institutions are buying\n- `\"distribution\"` — Stocks institutions are selling\n- `\"conviction\"` — High conviction positions (5%+ of portfolio)\n- `\"new\"` — Fresh institutional positions\n\n```\ninstitutional(\"manager\", identifier=\"Citadel\")     # What does Citadel own?\ninstitutional(\"security\", identifier=\"NVDA\")       # Who owns NVIDIA?\ninstitutional(\"signal\", signal_type=\"accumulation\") # Smart money buying\n```\n\n**Best for:** \"What is Berkshire buying?\", \"Who owns NVDA?\", \"Follow the smart money.\"\n\n---\n\n### `search(q)` — Find anything across the platform\n\n**Use when:** User is looking for something specific but doesn't know where it is.\n\n**Searches across:**\n- SEC 8-K filings (with LLM-extracted insights)\n- Companies (by name or symbol)\n- Insiders (executives, directors)\n- Institutional managers (13F filers)\n\n**Parameters:**\n- `q`: Search query (min 2 chars)\n- `entity_type`: Filter results — `\"filing\"`, `\"company\"`, `\"insider\"`, `\"manager\"`\n- `sector`: Filter by sector\n- `impact`: Filter filings by impact level — `\"HIGH\"`, `\"MEDIUM\"`, `\"LOW\"`\n- `limit`: Max results (default 20, max 100)\n\n```\nsearch(\"CEO resignation\")                           # Find CEO departure filings\nsearch(\"NVIDIA\", entity_type=\"company\")             # Find NVIDIA\nsearch(\"Buffett\", entity_type=\"insider\")            # Find Warren Buffett\nsearch(\"activist\", entity_type=\"manager\")           # Find activist funds\nsearch(\"acquisition\", sector=\"Technology\", impact=\"HIGH\")  # High-impact tech M&A\n```\n\n**Best for:** \"Find filings about X\", \"Search for Y\", discovery when you're not sure where to look.\n\n---\n\n### `service_info(info_type)` — Account and service information\n\n**Use when:** User asks about their subscription, features, or the service itself.\n\n**Info types:**\n- `\"overview\"` — Service description and capabilities (default)\n- `\"profile\"` — User's subscription tier, features, account status\n- `\"pricing\"` — Subscription tiers and pricing\n- `\"capabilities\"` — Available tools and data sources\n- `\"status\"` — Server health and configuration\n\n```\nservice_info()            # Overview\nservice_info(\"profile\")   # Your account\nservice_info(\"pricing\")   # Pricing info\n```\n\n**Best for:** \"What can you do?\", \"What's my tier?\", \"How much does PRO cost?\"\n\n---\n\n## Tool Selection Guide\n\n| User Intent | Tool |\n|-------------|------|\n| \"What's happening?\" / \"Market overview\" | `pulse()` |\n| \"Tell me about [company/insider/sector]\" | `investigate()` |\n| \"Find stocks where...\" / \"What opportunities...\" | `screen()` |\n| \"How's my [position]?\" / \"Should I worry about...\" | `assess()` |\n| \"What is [fund] buying?\" / \"Who owns [stock]?\" | `institutional()` |\n| \"Search for...\" / \"Find filings about...\" | `search()` |\n| \"What's my tier?\" / \"What can you do?\" | `service_info()` |\n\n---\n\n### MCP Prompts\n\nPre-built research workflows that produce complete reports:\n\n- `insider_activity_report` — Insider trading analysis for a symbol\n- `sec_filing_intelligence_report` — 8-K filing analysis\n- `macro_market_conditions_report` — Economic backdrop\n- `influential_investor_research` — Smart money deep dive\n- `sector_opportunity_scan` — Multi-signal sector analysis\n- `quarterly_stock_checkup` — Portfolio position review\n\n---\n\n## About This Repository\n\nThe Profitelligence MCP server runs as a hosted remote service at\n`https://mcp.profitelligence.com/mcp`. This repository is its public home:\n\n- **Tool documentation** — the full argument and response reference above\n- **`server.json`** — the [MCP registry](https://registry.modelcontextprotocol.io) manifest\n- **Client setup** — ready-to-paste configuration in [Quick Start](#quick-start)\n- **Security policy** — see [SECURITY.md](SECURITY.md)\n\nThere is nothing to install or run from here. Connect a client to the hosted\nendpoint with your API key and you have the full server.\n\n---\n\n## Privacy Policy\n\nSee our privacy policy: [profitelligence.com/privacy](https://profitelligence.com/privacy)\n\n---\n\n## Support\n\n- Issues: [GitHub Issues](https://github.com/profitelligence/profitelligence-mcp-server/issues)\n- Contact: [profitelligence.com/contact](https://profitelligence.com/contact)\n- Email: support@profitelligence.com\n\n## License\n\nMIT License - See [LICENSE](LICENSE) for details.\n",
  "bytes": 14664,
  "sha": "642c49307c703ebd9222eaf50ddd7a0935981026fa6e10893d97aef19212e100",
  "repo_slug": "profitelligence/profitelligence-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_profitelligence_mcp_server_6904c11d/readme"
}