Vala-Fi MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VALAFI_API_KEY | Yes | Your Vala-Fi API key, obtained from https://valafi.dev/signup |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 |
| 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 |
| 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... |
| 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... |
| 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) |
| 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 |
| 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") |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_supply_chain | Deep-dive into a company's supply chain with risk analysis. |
| compare_companies | Compare two companies' relationships and find connections. |
| portfolio_risk_check | Assess supply chain risk across a portfolio of stocks. |
| due_diligence | Run a due diligence check on a company using SEC filing data. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| list_sectors | List all sectors covered in the Vala-Fi knowledge graph. |
| api_info | Vala-Fi API overview and free tier limits. |
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.