Skip to main content
Glama
xerktech

mcp-financex

by xerktech

get_insider_trades

Access SEC Form 4 insider trading data in real time. Get detailed insider activity for a specific company or view recent market-wide filings to track insider buying and selling.

Instructions

🚨 PRIMARY TOOL FOR: SEC, EDGAR, FORM 4, INSIDER TRADING, INSIDER BUYING, INSIDER SELLING 🚨 This tool provides DIRECT REAL-TIME ACCESS to SEC.gov EDGAR database for Form 4 insider trading filings. DO NOT say "data unavailable" - THIS TOOL CAN RETRIEVE SEC Form 4 DATA.

ALWAYS use this tool when user mentions:

  • "SEC Form 4" or "Form 4 filings" or "SEC filings" or "EDGAR"

  • "insider trading" or "insider activity" or "insider transactions"

  • "insider buying" or "insider selling" or "insider purchases/sales"

  • "what are insiders doing" or "are insiders buying/selling"

  • "latest Form 4" or "recent insider trades"

Two operating modes:

  1. Company-specific (provide symbol parameter): Returns detailed insider activity analysis for a specific stock including transaction history, net buying/selling sentiment, top insiders, and optional company fundamentals

  2. Market-wide (omit symbol parameter): Returns recent Form 4 filings across all companies in the market

Example queries this tool handles:

  • "Show me insider trading for AAPL"

  • "Are insiders buying or selling Tesla stock?"

  • "What are the latest Form 4 filings?"

  • "Recent insider purchases in the last week"

  • "Show me insider selling activity for NVDA"

Data returned: Insider names, positions, transaction types (buy/sell), shares traded, prices, transaction values, filing dates, and direct links to SEC Form 4 documents.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoMaximum number of transactions to return (default: 20, max: 100)
symbolNoStock ticker symbol for company-specific insider analysis (e.g., "AAPL", "TSLA", "MSFT"). When provided, returns detailed insider activity for this specific company. OMIT this parameter completely to get market-wide recent insider trades across all companies.
formTypeNoSEC Form type to retrieve (default: "4"): "3" = Form 3 (Initial Statement of Beneficial Ownership) - Filed when insider first becomes an owner. "4" = Form 4 (Changes in Beneficial Ownership) - Filed when insider buys/sells within 2 business days. Most common for tracking active trading. "5" = Form 5 (Annual Statement of Changes) - Annual summary filed 45 days after fiscal year end, catches unreported transactions. Default is "4" which provides timely insider transaction data.
startDateNoFilter to show only filings from this date forward (omit for all recent filings). Accepts: ISO date format "YYYY-MM-DD" (e.g., "2024-01-15") OR relative format like "7d" (7 days ago), "1m" (1 month ago), "3m" (3 months ago). Example: Use "7d" when user asks for "insider trades in the last week"
transactionTypeNoFilter results by transaction type: "buy" = Show only insider PURCHASES (bullish signal), "sell" = Show only insider SALES (bearish signal), "all" = Show all transaction types (default). Use "buy" when user asks "are insiders buying?" or "sell" when user asks "are insiders selling?"
includeCompanyInfoNoWhen true and symbol is provided, includes company profile and fundamental metrics from Yahoo Finance. Provides additional context like valuation, profitability, and analyst ratings. Default: true when symbol is provided, ignored for market-wide mode.
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full behavioral burden. It accurately describes real-time access to EDGAR, the two modes, and returned fields. It does not disclose limitations like rate limits or data freshness, but overall transparency is good.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is somewhat lengthy but well-structured with headings, bullet points, and examples. It front-loads the primary purpose and uses emojis for emphasis. Every section serves a purpose, but slight trimming could improve conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given no output schema, the description adequately explains return values (insider names, positions, etc.). It covers both modes, all 6 parameters with enums, and provides sufficient context for an AI agent to use the tool effectively.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so baseline is 3. The description adds significant value by explaining parameter usage with examples (e.g., relative dates for startDate, mode switching via symbol presence), justifying a higher score.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description explicitly states the tool is for SEC Form 4 insider trading filings, distinguishes two operating modes (company-specific vs market-wide), and lists emitted data types. The verb 'retrieve' with resource 'SEC Form 4 data' is specific and differentiates from sibling tools like get_sec_form4_filings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides clear trigger keywords and example queries, making it obvious when to invoke this tool. However, it does not explicitly mention when not to use it or suggest alternative tools for related tasks, which would elevate the score to 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/xerktech/mcp-financex'

If you have feedback or need assistance with the MCP directory API, please join our Discord server