Skip to main content

AI Agent Tools Reference

Complete reference for all 12 AI Agent tools available in Vartovii.

Tool Summary​

Corporate Intelligence (6 tools)​

ToolPurposeParameters
search_companyFind company in databasecompany_name, country?
get_trust_scoreDetailed Trust Score breakdowncompany_name
list_companiesTop employers rankingcountry?, limit?, sort_by?
compare_companiesCompare two employerscompany1, company2
run_analysisStart analysis for new companycompany_name, country?, category?
get_company_reviewsShow sample reviewscompany_name, sentiment?, limit?

Crypto Intelligence (2 tools)​

ToolPurposeParameters
search_crypto_projectsFind crypto projectsquery
get_crypto_trust_scoreGet Crypto Trust Scoreslug

Forensic Agent (4 tools)​

ToolPurposeParameters
check_walletCheck ETH balanceaddress
get_transaction_historyGet wallet transactionsaddress, limit?, days?
get_token_holdersToken holder distributioncontract_address, limit?
get_contract_infoVerify smart contractcontract_address

1. search_company​

Search for a company in the database.

Parameters​

NameTypeRequiredDescription
company_namestring✅Company name to search
countrystring❌Country code (de, at, ch)

Example​

User: "Find BMW company"

Response​

{
  "found": true,
  "company_name": "BMW",
  "trust_score": 71,
  "avg_rating": 3.97,
  "review_count": 5621,
  "sentiment_positive": 50,
  "sentiment_negative": 50,
  "data_freshness": "fresh (< 7 days)"
}

2. get_trust_score​

Get detailed Trust Score with breakdown.

Parameters​

NameTypeRequiredDescription
company_namestring✅Company name

Response​

{
  "company_name": "BMW",
  "trust_score": 71,
  "risk_level": "MEDIUM",
  "breakdown": {
    "rating_quality": 23.8,
    "sentiment": 12.5,
    "volume": 20,
    "consistency": 10,
    "recency": 5
  }
}

3. list_companies​

Get top employers ranked by Trust Score.

Parameters​

NameTypeRequiredDefaultDescription
countrystring❌allFilter by country
limitinteger❌10Number of companies
sort_bystring❌trust_scoreSorting field

Example​

User: "Show top 5 companies"

Response​

Returns list of companies with:

  • Company name
  • Trust Score
  • Review count
  • Average rating

4. compare_companies​

Compare two employers side-by-side.

Parameters​

NameTypeRequiredDescription
company1string✅First company
company2string✅Second company

Example​

User: "Compare BMW and Audi"

Response​

{
  "company1": {
    "name": "BMW",
    "trust_score": 71,
    "review_count": 5621,
    "avg_rating": 3.97
  },
  "company2": {
    "name": "Audi",
    "trust_score": 57,
    "review_count": 1243,
    "avg_rating": 3.45
  },
  "winner": "BMW",
  "score_difference": 14
}

5. run_analysis​

Start data collection and analysis for a NEW company.

Magic Search

This tool triggers our "Magic Search" system that searches Kununu, starts scraping from multiple sources, and creates a full analysis.

Parameters​

NameTypeRequiredDefaultDescription
company_namestring✅-Company to analyze
countrystring❌deCountry code

Example​

User: "Analyze Spotify company"

Response​

{
  "action": "analysis_started",
  "company_name": "Spotify",
  "company_slug": "spotify-ab1",
  "scraping_jobs": ["job-1", "job-2", "job-3", "job-4"],
  "message": "🚀 Analysis started! Check back in 5-10 minutes."
}

Job Types Started​

  1. Kununu - Main review source
  2. Google Reviews - Business ratings
  3. Reddit - Employee discussions
  4. Indeed Vacancies - Job market data

6. get_company_reviews​

Get sample employee reviews.

Parameters​

NameTypeRequiredDefaultDescription
company_namestring✅-Company name
sentimentstring❌allFilter: positive, negative, all
limitinteger❌5Number of reviews (max 10)

Example​

User: "Show reviews for BMW"

Response​

{
  "company_name": "BMW",
  "reviews": [
    {
      "text": "👍 Great work-life balance, interesting projects...",
      "rating": 4.5,
      "sentiment": "POSITIVE",
      "source": "kununu"
    },
    {
      "text": "👎 Management could be better, communication issues...",
      "rating": 2.5,
      "sentiment": "NEGATIVE", 
      "source": "kununu"
    }
  ],
  "summary": {
    "total": 5,
    "positive": 3,
    "negative": 2
  }
}

Trigger Keywords​

The AI Agent automatically activates when it detects these keywords:

English​

  • company, employer, find, search, compare
  • trust score, rating, top, best, worst
  • analyze, reviews, analysis

Ukrainian​

  • компанія, роботодавець, знайди, пошук
  • траст скор, рейтинг, топ, порівняй
  • проаналізуй, відгуки, аналіз

7. search_crypto_projects​

Search for cryptocurrency projects in the database.

Parameters​

NameTypeRequiredDescription
querystring✅Project name, symbol, or slug (e.g., "Bitcoin", "BTC", "Solana")

Example​

User: "Find Solana project"

Response​

{
  "found": true,
  "count": 1,
  "results": [
    {
      "slug": "solana",
      "name": "Solana", 
      "symbol": "SOL",
      "price_usd": 102.5,
      "market_cap": 45123456789,
      "trust_score": 85,
      "risk_level": "LOW"
    }
  ],
  "message": "Found 1 project matching 'Solana'. Use the slug for detailed analysis."
}

8. get_crypto_trust_score​

Get comprehensive Trust Score and project data for a crypto project.

Parameters​

NameTypeRequiredDescription
slugstring✅Project slug from search results (e.g., "solana", "bitcoin")

Response​

{
  "found": true,
  "name": "Solana",
  "symbol": "SOL",
  "slug": "solana",
  "price_usd": 102.5,
  "market_cap": 45123456789,
  "fdv": 55000000000,
  "trust_score": 85,
  "risk_level": "LOW",
  "score_breakdown": {
    "treasury": 75,
    "dev_activity": 90,
    "financials": 85,
    "security": 80,
    "tokenomics": 88,
    "community": 82
  },
  "treasury_usd": 12500000,
  "runway_months": 25,
  "github_org": "solana-labs",
  "commits_last_30d": 450,
  "active_devs": 35
}

9. check_wallet​

Check ETH balance for any Ethereum wallet address.

Parameters​

NameTypeRequiredDescription
addressstring✅Ethereum address (0x...)

Example​

User: "Check balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

Response​

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "eth_balance": 32.1112,
  "usd_value": 94241.62,
  "found": true,
  "chain": "ethereum",
  "etherscan_link": "https://etherscan.io/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}

10. get_transaction_history​

Get recent transaction history for a wallet address.

Parameters​

NameTypeRequiredDefaultDescription
addressstring✅-Ethereum address
limitinteger❌10Max transactions to return
daysinteger❌30Look back period

Example​

User: "Show transactions for 0xd8dA... in last 30 days"

Response​

{
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "transactions": [
    {
      "hash": "0x123...",
      "from": "0xabc...",
      "to": "0xd8dA...",
      "value_eth": 2.5,
      "value_usd": 7334.15,
      "timestamp": "2026-01-20T10:30:00Z",
      "direction": "in"
    }
  ],
  "count": 5,
  "etherscan_link": "https://etherscan.io/address/0xd8dA...#transactions"
}

11. get_token_holders​

Analyze token holder distribution for ERC20 tokens.

Parameters​

NameTypeRequiredDefaultDescription
contract_addressstring✅-ERC20 token contract address
limitinteger❌20Max holders to return

Example​

User: "Top holders of USDT"

Response​

{
  "contract_address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "token_symbol": "USDT",
  "token_price_usd": 0.998,
  "holders": [
    {
      "rank": 1,
      "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
      "balance": "21,951,179,974.29 USDT",
      "balance_usd": 21925650751.98,
      "percentage": 18.5
    }
  ],
  "count": 20,
  "total_supply": 118490426863.74,
  "etherscan_link": "https://etherscan.io/token/0xdac17f..."
}

12. get_contract_info​

Verify smart contract details and type.

Parameters​

NameTypeRequiredDescription
contract_addressstring✅Smart contract address

Example​

User: "Is 0xdAC17F... an ERC20 contract?"

Response​

{
  "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
  "found": true,
  "is_erc20": true,
  "is_erc721": false,
  "deployed_at": "2017-11-28T00:41:21+00:00",
  "has_bytecode": true,
  "contract_type": "ERC20 Token",
  "etherscan_link": "https://etherscan.io/address/0xdac17f..."
}

Trigger Keywords​

The AI Agent automatically activates when it detects these keywords:

English​

  • Corporate: company, employer, find, search, compare
  • Crypto: crypto, token, coin, price, market cap, project
  • Forensic: wallet, address, balance, transaction, holder, contract, 0x
  • Analysis: trust score, rating, top, best, worst, analyze, reviews

Ukrainian​

  • Корпоративні: компанія, роботодавець, знайди, пошук, порівняй
  • Крипто: крипта, токен, монета, ціна, проект
  • Форензік: гаманець, адреса, баланс, транзакції, контракт
  • Аналіз: траст скор, рейтинг, топ, проаналізуй, відгуки