01 / Getting Started

Universal Quickstart

company-intelligence provides instant access to corporate filings and technical registries without requiring any API keys:

# ⚡ Option 1: Universal 1-Line Installer
curl -fsSL https://company-intelligence.builditwithai.xyz/install | bash

# 🐍 Option 2: Run via Python (uvx)
uvx company-intelligence

# 📦 Option 3: Run via Node (npx)
npx -y company-intelligence
02 / Multi-Source Grounding

The 5 Intelligence Layers

Instead of querying raw web search engines that hallucinate financial numbers, company-intelligence queries authoritative public registries directly:

1. 📊 Audited US-GAAP Financials

5-year standardized tables from SEC EDGAR Company Facts: Revenue, Gross Margin %, Operating Margin %, Net Income, R&D Expense, and Operating Cash Flow.

2. 📑 Regulatory Filings Radar

Tracks recent 10-K annuals, 10-Q quarterlies, 8-K material events, Form 4 insider transactions, and Form 144 disclosures with direct SEC archive URLs.

3. 🌐 DNS Tech Stack Fingerprint

Real-time DNS probe (MX, TXT, SPF, NS) detecting email infrastructure (Google vs M365), hosting/CDN, and 20+ SaaS tool signatures (Salesforce, Stripe, PostHog, Datadog).

4. 🔬 R&D IP & Patents

Corporate engineering research publications, conference proceedings (IEEE, ACM, CVPR), and granted USPTO patent filings.

5. 🏛️ Federal Procurement

Historical US prime contractor federal awards, awarding agencies, and contract values via USAspending.gov.

03 / Agent Integration

AI Agent Integration

Add company-intelligence to your agent runtime:

Claude Desktop & Claude Code

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "company-intelligence": {
      "command": "uvx",
      "args": ["--from", "company-intelligence", "company-intelligence"]
    }
  }
}

Cursor, Windsurf & Antigravity

Add to IDE settings:

{
  "mcpServers": {
    "company-intelligence": {
      "command": "npx",
      "args": ["-y", "company-intelligence"]
    }
  }
}
04 / API & Tools

Tool & Parameter Reference

Tool Name Parameters Description
get_company_dossier query (ticker or domain) 1-call comprehensive B2B account dossier combining financials, filings, tech stack, R&D, and federal contracts.
get_financial_statements ticker_or_cik, periods Standardized 5-year annual US-GAAP financial metrics and margin trends.
get_tech_stack_fingerprint domain Live DNS inspection detecting email, hosting, and SaaS vendor signatures.
get_sec_filings_radar ticker_or_cik, limit Recent regulatory filings and material event disclosures from SEC EDGAR.
get_patent_portfolio company_name, max_patents Corporate engineering publications and patent grants.
get_federal_contracts company_name, limit US federal contract procurement history and prime award values.
05 / Output Format

Sample Executive Output

When an agent calls get_company_dossier("SNOW"), it receives a structured markdown summary optimized for immediate analysis:

# 🏢 Snowflake Inc. (NYSE: SNOW · CIK: 0001640147)
- **Domain:** snowflake.com
- **Revenue (FY24):** $2.81B (+35.8% YoY)
- **Gross Margin:** 67.8% | **R&D Intensity:** 34.2% of Revenue
- **Email Infrastructure:** Google Workspace (MX: aspmx.l.google.com)
- **Cloud & CDN:** Amazon Web Services, Cloudflare
- **Active SaaS Vendors:** Salesforce, Marketo, Stripe, Workday, Datadog
- **Granted Patents:** 142 (Data warehousing, query acceleration, secure sharing)
- **Federal Awards:** DoD, Dept of Veterans Affairs ($18.4M active obligations)