Vala-Fi MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Vala-Fi MCP Server Who are Apple's main suppliers?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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
Remote Server (Recommended — zero install)
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 |
| Company name, sector, industry, exchange |
| Upstream/downstream relationships (1-3 hops) |
| All known customers with SEC citations |
| All known competitors with SEC citations |
| Shortest path between two companies |
| Supply chain concentration risk analysis |
| Full sector relationship subgraph (paid tier) |
Prompts
Pre-built prompt templates you can invoke directly:
Prompt | Description |
| Deep-dive a company's suppliers, customers, competitors, and concentration risk |
| Compare two companies — shared suppliers, paths, competitive overlap |
| Cross-portfolio supply chain risk assessment (pass comma-separated tickers) |
| Structured due diligence memo from SEC filing data |
Resources
Resource URI | Description |
| List of all 11 sectors covered in the knowledge graph |
| 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-KDirect 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/AAPLFull 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
Links
Website: valafi.dev
API Docs: valafi.dev/docs
Get API Key: valafi.dev/signup
Pricing: valafi.dev/pricing
License
MIT — use it however you want.
Available Tools
7 toolsfind_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
Scored across 7 tools
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.
All tools follow a consistent verb_noun pattern in snake_case (e.g., get_company_profile, find_path). The naming is predictable and clear.
Seven tools is well-scoped for a knowledge graph API, covering essential queries without being overwhelming. Each tool earns its place.
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
Related MCP Connectors
Private company data, entity-resolved news, targeted lists, and alternative signals for AI agents.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
Company and market intelligence, news, enrichment, and agentic workflows for dealmakers.
Evidence-backed capital-change intelligence and sourced financial data for AI agents
Related MCP Servers
- AlicenseAqualityCmaintenanceCompanyLens 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.5201 npm4MIT
- AlicenseNot gradedqualityDmaintenanceFinancial 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.MIT
- AlicenseNot gradedqualityCmaintenanceHosted 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.1MIT

Qorenext CRM MCPofficial
AlicenseNot gradedqualityBmaintenanceReal-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