Skip to main content
Glama
Vala-Fi MCP Server

Vala-Fi MCP Server

Vala-Fi MCP Server

A Bloomberg Terminal you can talk to. Query company relationships — suppliers, customers, competitors, supply chain paths — directly from Claude, Cursor, or any MCP-compatible AI assistant.

Every relationship is extracted from SEC 10-K filings. Every edge has a citation. No black boxes.

MCP Badge License: MIT Python 3.10+


Why This Exists

Bloomberg Terminal costs $24,000/year. FactSet starts at $12,000. PitchBook won't even show you pricing without a sales call.

Vala-Fi gives you the same company relationship data for free.

We extract supplier, customer, and competitor relationships from SEC 10-K annual filings using AI — the same source of truth that institutional investors rely on. The difference: you get it as a structured API with graph traversal, not a 200-page PDF.

5,200+ companies. 8,000+ relationships. 11 sectors. Free during beta.


Related MCP server: Profitelligence MCP Server

Quick Start

1. Get a free API key

Sign up at valafi.dev/signup — takes 10 seconds, no credit card.

2. Configure your AI assistant

No packages to install. Just paste the config and go.

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "vala-fi": {
      "url": "https://mcp.valafi.dev/mcp",
      "headers": {
        "X-API-Key": "vfi_your_key_here"
      }
    }
  }
}

Cursor — add to .cursor/mcp.json:

{
  "mcpServers": {
    "vala-fi": {
      "url": "https://mcp.valafi.dev/mcp",
      "headers": {
        "X-API-Key": "vfi_your_key_here"
      }
    }
  }
}

Windsurf / Claude Code — same config format as above.

Local Server (Alternative — runs on your machine)

If you prefer running the server locally (required for Claude Desktop):

{
  "mcpServers": {
    "vala-fi": {
      "command": "/full/path/to/uvx",
      "args": ["vala-fi-mcp"],
      "env": {
        "VALAFI_API_KEY": "vfi_your_key_here"
      }
    }
  }
}

Find your uvx path by running which uvx in your terminal. Requires Python 3.10+ and uv.

3. Start asking questions

That's it. Your AI assistant now has access to a financial knowledge graph.


Available Tools

Tool

Description

get_company_profile

Company name, sector, industry, exchange

get_supply_chain

Upstream/downstream relationships (1-3 hops)

get_customers

All known customers with SEC citations

get_competitors

All known competitors with SEC citations

find_path

Shortest path between two companies

get_exposure

Supply chain concentration risk analysis

get_sector_graph

Full sector relationship subgraph (paid tier)


Prompts

Pre-built prompt templates you can invoke directly:

Prompt

Description

analyze_supply_chain

Deep-dive a company's suppliers, customers, competitors, and concentration risk

compare_companies

Compare two companies — shared suppliers, paths, competitive overlap

portfolio_risk_check

Cross-portfolio supply chain risk assessment (pass comma-separated tickers)

due_diligence

Structured due diligence memo from SEC filing data


Resources

Resource URI

Description

valafi://sectors

List of all 11 sectors covered in the knowledge graph

valafi://api-info

API overview, endpoint URL, and free tier limits


What You Can Do

Ask your AI assistant questions like:

  • "Who are Apple's top suppliers?"

  • "Find the connection between Tesla and NVIDIA"

  • "What companies depend on TSMC as a sole supplier?"

  • "Show me all competitors of Microsoft mentioned in SEC filings"

  • "What's the supply chain risk for my portfolio: AAPL, MSFT, GOOGL?"

Every answer comes with the SEC filing citation so you can verify it yourself.


Use Cases

Solo Developer / Indie Hacker

You're building a stock analysis tool and need to understand company relationships without paying for a Bloomberg Terminal. Vala-Fi gives you structured supply chain data through a simple API.

AI Agent Builder

You're building an autonomous research agent that needs to answer questions like "What happens to Apple if TSMC has a production issue?" Plug in Vala-Fi as an MCP tool and your agent can traverse the financial graph.

Quantitative Researcher

You're modeling supply chain risk or building factor models that incorporate inter-company dependencies. Query the graph programmatically and get SEC-cited evidence for every relationship.

Due Diligence Analyst

You're evaluating an acquisition target and need to quickly map their supplier/customer network. One API call gives you the full picture with citations.

Financial Content Creator

You're writing analysis and need to verify company relationships. Instead of reading 10-K filings manually, query the graph and get the exact excerpt.


Free Tier Limits

Limit

Value

Requests per day

50

Unique tickers per day

10

Results per query

5

Max hop depth

2

Strength scores

Included

SEC citations

All results

Sector graph

Paid only

Need more? Contact us.


Example Session

You: Who are NVIDIA's main suppliers according to SEC filings?

Claude: Based on NVIDIA's SEC 10-K filings, here are their key suppliers:

1. **TSMC** (TSM) - Primary foundry partner manufacturing NVIDIA's GPUs
   "Taiwan Semiconductor Manufacturing Company Limited manufactures
   our GPUs and Tegra processors..." — NVIDIA 10-K

2. **Samsung Electronics** - Secondary foundry for certain chip production
   "Samsung manufactures different different different different..." — NVIDIA 10-K

3. **Amkor Technology** (AMKR) - Packaging and testing services
   "We use third-party foundries, including TSMC and Samsung,
   and packaging and test providers such as Amkor..." — NVIDIA 10-K

Direct API Usage (Without MCP)

Don't need an AI assistant? Use the REST API directly:

# Get Apple's suppliers
curl -H "X-API-Key: vfi_your_key" \
  https://api.valafi.dev/v1/company/AAPL/supply-chain

# Find path between Tesla and NVIDIA
curl -H "X-API-Key: vfi_your_key" \
  https://api.valafi.dev/v1/path/TSLA/NVDA

# Get supply chain risk for a company
curl -H "X-API-Key: vfi_your_key" \
  https://api.valafi.dev/v1/exposure/AAPL

Full API documentation: valafi.dev/docs


Data Source

All relationship data is extracted from SEC 10-K annual filings using AI. We do not scrape news, social media, or third-party databases.

  • Source: SEC EDGAR

  • Coverage: 5,200+ public companies across 11 GICS sectors

  • Update frequency: As new 10-K filings are published (primarily Q1 and Q3)

  • Relationship types: supplier, customer, competitor, partner, and more



License

MIT — use it however you want.

Available Tools

7 tools
find_pathA

Find the shortest path between two companies in the knowledge graph.

Discovers how two companies are connected through supplier, customer, and competitor relationships. Great for finding hidden connections.

Example: find_path("AAPL", "NVDA") -> Apple -> TSMC -> NVIDIA (connected through shared semiconductor supplier)

Inputs: ticker_a (required), ticker_b (required).

get_company_profileA

Get company profile by ticker symbol.

Returns basic company information including name, sector, industry, country, and exchange. Use this to look up any company in the graph.

Example: get_company_profile("AAPL") -> Apple Inc., Technology, Consumer Electronics

Inputs: ticker (required).

get_competitorsA

Get all known competitors of a company.

Competitors are identified from SEC 10-K filings where companies explicitly name their competitive landscape.

Example: get_competitors("AAPL") -> Microsoft, Samsung, Google...

Inputs: ticker (required).

get_customersA

Get all known customers of a company.

Returns companies that list the queried company as a supplier in their SEC 10-K filings. Each relationship includes citation evidence.

Example: get_customers("TSM") -> Apple, NVIDIA, AMD, Qualcomm...

Inputs: ticker (required).

get_exposureA

Get supply chain exposure and concentration risk analysis.

Identifies shared suppliers/customers across peer companies and flags single-source dependencies. Returns an exposure score.

Example: get_exposure("AAPL") -> Shows TSMC as a high-risk sole supplier, shared suppliers with peers

Inputs: ticker (required).

get_sector_graphA

Get the full relationship subgraph for an entire sector.

Returns all companies and edges within the specified sector. Note: This endpoint requires a paid tier.

Args: sector: Sector name (e.g. "Technology", "Healthcare", "Energy", "Financial Services", "Consumer Cyclical", "Industrials", "Communication Services", "Consumer Defensive", "Basic Materials", "Real Estate", "Utilities") relationship_types: Optional comma-separated filter (e.g. "supplier,customer")

Example: get_sector_graph("Technology", relationship_types="supplier")

Inputs: sector (required), relationship_types.

get_supply_chainA

Get the supply chain for a company.

Traverses the knowledge graph to find suppliers, customers, or both. Each relationship includes SEC 10-K citation evidence.

Args: ticker: Stock ticker (e.g. "AAPL", "TSLA") hops: Depth of traversal (1 = direct relationships, 2 = second-degree). Free tier: max 2. direction: "upstream" (suppliers), "downstream" (customers), or "both"

Example: get_supply_chain("AAPL", hops=2, direction="both") -> Shows Apple's suppliers, their suppliers, and Apple's customers

Inputs: ticker (required), hops, direction.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: profile lookup, path discovery, competitor/customer lists, supply chain traversal, sector subgraph, and exposure analysis. No overlap or ambiguity.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case (e.g., get_company_profile, find_path). The naming is predictable and clear.

    Tool Count5/5

    Seven tools is well-scoped for a knowledge graph API, covering essential queries without being overwhelming. Each tool earns its place.

    Completeness5/5

    The tool set covers all typical query needs for a company relationship graph: profile, competitors, customers, supply chain, path finding, sector view, and risk analysis. No obvious gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      CompanyLens MCP gives your AI assistant access to real corporate data from official government sources. No web scraping, no hallucinations — verified data from SEC EDGAR, UK Companies House, OpenSanctions, and USAspending.gov.
      5
      201 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Hosted MCP server providing corporate ownership intelligence, enabling AI agents to look up parent companies, PE backing, corporate families, and portfolio siblings via natural language queries.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Real-time CRM intelligence for Claude and other AI clients — map corporate ownership hierarchies, verify entity names and registered addresses, and detect duplicate records, directly in chat. No manual lookups, no spreadsheets, no messy data.
      MIT