{"report":{"v":1,"package":"generect-ultimate-mcp","version":"0.13.2","ranAt":"2026-11-16T11:56:17.853Z","install":{"ok":true,"integrity":"sha512-q4eSQJxUebEZmjvS4gIPlQHEl8dr6meRbrW4LlQoMgZJx5EJG4iIQ/LqvyoeVVaMmwWEXUBOogzBY8OAUVBAMA==","deps":92,"scripts":[],"bins":["generect-mcp"],"license":"MIT","engines":"node >=20","repository":"git+https://github.com/generect/generect_mcp.git","bin":"generect-mcp"},"start":{"ok":true,"ms":185,"serverName":"generect-api","serverVersion":"0.13.2","protocol":"2025-06-18","stderr":"{\"ts\":\"2026-11-16T11:56:25.425Z\",\"event\":\"tool_call\",\"reqId\":\"55d039c7-3fe5-49fe-ae2e-ffe70ff0901f\",\"tool\":\"get_balance\",\"input\":{}}\n{\"ts\":\"2026-11-16T11:56:25.426Z\",\"event\":\"tool_result\",\"reqId\":\"55d039c7-3fe5-49fe-ae2e-ffe70ff0901f\",\"tool\":\"get_balance\",\"ms\":1,\"test_mode\":false,\"output\":{\"text\":\"<str:85>\",\"structuredContent\":{\"error\":\"<str:32>\",\"status\":null,\"detail\":null},\"isError\":\"<boolean>\"}}\n{\"ts\":\"2026-11-16T11:56:25.429Z\",\"event\":\"tool_call\",\"reqId\":\"52e39de9-08c8-498e-9c65-e3e038cbc178\",\"tool\":\"health\",\"input\":{}}\n{\"ts\":\"2026-11-16T11:56:25.429Z\",\"event\":\"tool_result\",\"reqId\":\"52e39de9-08c8-498e-9c65-e3e038cbc178\",\"tool\":\"health\",\"ms\":0,\"test_mode\":false,\"output\":{\"text\":\"<str:260>\",\"structuredContent\":{\"ok\":\"<boolean>\",\"server\":\"<str:2>\",\"version\":\"<str:6>\",\"api_base\":\"<str:24>\",\"cost\":{\"operation\":\"<str:6>\",\"amount_charged_usd\":\"<number>\",\"billed\":\"<str:33>\"},\"has_credential\":\"<boolean>\",\"ms\":\"<number>\"}}}\n{\"ts\":\"2026-11-16T11:56:25.432Z\",\"event\":\"tool_call\",\"reqId\":\"aa01cb26-76d4-4f6b-9071-dfb623089634\",\"tool\":\"list_webhooks\",\"input\":{}}\n{\"ts\":\"2026-11-16T11:56:25.432Z\",\"event\":\"tool_result\",\"reqId\":\"aa01cb26-76d4-4f6b-9071-dfb623089634\",\"tool\":\"list_webhooks\",\"ms\":0,\"test_mode\":false,\"output\":{\"text\":\"<str:85>\",\"structuredContent\":{\"error\":\"<str:32>\",\"status\":null,\"detail\":null},\"isError\":\"<boolean>\"}}\n"},"tools":[{"name":"count_leads","description":"How many leads match an ICP, and what pulling them would cost at this account's prices. Free: this call never spends credits. It is the only way to size an audience without paying per row, which makes it the first step before search_leads. A realtime count is not free ($0.04 flat at the Tier 0 list price); it runs only when mode:\"realtime\" is passed explicitly.","params":["job_titles","seniorities","locations","exclude_locations","company_locations","exclude_company_locations","company_industries","exclude_company_industries","company_headcounts","exclude_company_headcounts","company_types","company_name","company_link","company_id","exclude_names","exclude_ids","filter_empty_vars","strict","allow_unlisted_values","keywords","functions","past_company_names","years_in_position","years_in_company","changed_jobs","posted_on_linkedin","linkedin_filter_link","personas","job_title","exclude_title_keywords","without_company","get_max_leads","lead_industries","company_filters","mode","timeout_ms"]},{"name":"count_companies","description":"How many companies match an ICP, and what pulling them would cost. Free: this call never spends credits. The first step before search_companies. As with count_leads, a realtime count costs $0.04 at the Tier 0 list price and runs only when mode:\"realtime\" is passed explicitly.","params":["industries","exclude_industries","sub_industries","headcounts","locations","exclude_locations","company_types","exclude_domains","exclude_ids","keywords","company_names","technologies","num_of_followers","revenues_range","department_headcount","headcount_growth","hiring_on_linkedin","linkedins_links","allow_unlisted_values","get_max_companies","fallback_from_leads","mode","timeout_ms"]},{"name":"get_balance","description":"Account balance, month-to-date usage and this account's own per-operation prices. Free: this call never spends credits. balance_usd is the wallet; grants_usd is bonus and plan credit (sign-up bonus, perks, plan allowance), reported apart. Grants are spent first, but only on the operations each one covers: a promo perk or a plan allowance may not pay for API calls, and a perk never pays for phone numbers, so the two figures do not add up to what the account can spend. Useful before a batch of paid work (what the user can afford) and after it (what was spent). These are the account's real rates; prices in tool descriptions are list prices.","params":["include_transactions","include_prices","include_usage","include_token_analytics","timeout_ms"]},{"name":"health","description":"Liveness check. Free: this call never spends credits. Confirms the MCP server is up, reports its version and (unless disabled) verifies the credential against a free account endpoint. It never touches a paid data endpoint, so it is safe for monitors.","params":["check_credential","timeout_ms"]},{"name":"preview_leads","description":"A cheap look at the actual people behind a count, before a full search. Billable: about $0.002 per returned row at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. Preview rows carry a Generect `id`, so the usual flow is: preview many, pick the few that fit, then enrich_lead or generate_email only on those. By the API contract preview rows are masked (no LinkedIn URL, domain, email or phone); an account that gets more than that cannot rely on it.","params":["job_titles","seniorities","locations","exclude_locations","company_locations","exclude_company_locations","company_industries","exclude_company_industries","company_headcounts","exclude_company_headcounts","company_types","company_name","company_link","company_id","exclude_names","exclude_ids","filter_empty_vars","strict","allow_unlisted_values","keywords","functions","past_company_names","years_in_position","years_in_company","changed_jobs","posted_on_linkedin","linkedin_filter_link","personas","job_title","exclude_title_keywords","without_company","get_max_leads","lead_industries","company_filters","compact","count_only","limit_by","offset_by","limit","timeout_ms","confirm_spend_usd"]},{"name":"search_leads","description":"Return leads (people) matching an ICP. Free by default while the account has free thin rows left today (a daily quota; detail \"thin\" guarantees $0). detail \"full\" is billable: about $0.02 per returned row (0 rows costs $0) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. Realtime, and an automatic escalation to it, are billed per row too. count_leads sizes the audience for free first. Rows never include email or phone; generate_email (which takes the lead id) and find_phone add those for the ids you keep. Ordering is not stable, so pages are fetched by passing the ids you already have in exclude_ids rather than by offset.","params":["job_titles","seniorities","locations","exclude_locations","company_locations","exclude_company_locations","company_industries","exclude_company_industries","company_headcounts","exclude_company_headcounts","company_types","company_name","company_link","company_id","exclude_names","exclude_ids","filter_empty_vars","strict","allow_unlisted_values","keywords","functions","past_company_names","years_in_position","years_in_company","changed_jobs","posted_on_linkedin","linkedin_filter_link","personas","job_title","exclude_title_keywords","without_company","get_max_leads","lead_industries","company_filters","mode","detail","compact","limit_by","offset_by","limit","offset","timeout_ms","confirm_spend_usd"]},{"name":"search_companies","description":"Return companies matching an ICP. Free by default while the account has free thin rows left today (a daily quota; detail \"thin\" guarantees $0). Thin rows carry no domain; enrich_company adds it for the ones you keep. detail \"full\" is billable: about $0.02 per returned row (0 rows costs $0) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. Realtime is billed per row too. count_companies sizes the result for free first. headcount_range is a snapshot taken when the record was indexed and can lag the company's current size; the filter itself is applied at query time.","params":["industries","exclude_industries","sub_industries","headcounts","locations","exclude_locations","company_types","exclude_domains","exclude_ids","keywords","company_names","technologies","num_of_followers","revenues_range","department_headcount","headcount_growth","hiring_on_linkedin","linkedins_links","allow_unlisted_values","get_max_companies","fallback_from_leads","mode","detail","compact","limit_by","offset_by","limit","offset","timeout_ms","confirm_spend_usd"]},{"name":"resolve_profile","description":"Reveal who is behind an anonymous LinkedIn profile link. Billable: about $0.0005 per resolved profile (an unresolvable reference is free; duplicates in one batch are billed per row) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. Takes the obfuscated links that Sales Navigator leaves in exports, CRMs and ad platforms (`linkedin.com/in/ACwAA…`), plus Sales Navigator lead URLs, bare profile ids and urns, and returns the real profile URL and identity. `profiles` (up to 50) resolves a batch in one call. The `id` it returns is the identifier enrich_lead, generate_email and find_phone accept, so this is the cheap first step before a full record. Returns identity only (no location, company or work history; enrich_lead has those). The numeric member id is not accepted as input (LinkedIn answers 403 to it); it comes back as `linkedin_id`.","params":["url","id","profiles","compact","timeout_ms"]},{"name":"enrich_lead","description":"Full profile for one known person, by Generect id, LinkedIn URL or work email (reverse lookup). Billable: about $0.02 per record found (not-found is refunded) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. Not found costs nothing. The `id` from a search or preview result is the most accurate identifier. start_bulk_job handles many people at once.","params":["id","linkedin_url","email","mode","compact","timeout_ms"]},{"name":"enrich_company","description":"Full profile for one known company, by Generect id, LinkedIn URL, domain or name. Billable: about $0.02 per record found (not-found is refunded) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. Not found costs nothing. Domain is the most reliable identifier after id; name matching is fuzzy.","params":["id","linkedin_url","domain","name","mode","compact","timeout_ms"]},{"name":"get_lead_by_url","description":"Alias of enrich_lead for a LinkedIn profile URL, kept for backwards compatibility. Billable: about $0.02 per record found (not-found is refunded) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. enrich_lead does the same and also accepts a Generect id (the most accurate identifier) or an email for reverse lookup.","params":["url","comments","posts","people_also_viewed","inexact_company","mode","compact","timeout_ms"]},{"name":"generate_email","description":"Find and verify a work email. Billable: about $0.02 per VALID email found (a miss is free) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. Identifies the person by lead_id (most accurate), LinkedIn URL or first name, last name and domain. `candidates` resolves several people in one call; more than 10 go to an async bulk job instead, which returns a job_id for get_bulk_job.","params":["lead_id","linkedin_url","first_name","last_name","domain","middle_name","candidates","timeout_ms"]},{"name":"validate_email","description":"Check deliverability of emails you already have. Billable: about $0.005 per email submitted (every address is billed, whatever the verdict) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. This is the one operation where every submitted address is billed: the verdict is the deliverable. An address generate_email returned as valid is already verified, so validating it again only adds cost.","params":["emails","timeout_ms"]},{"name":"find_phone","description":"Find a phone number for one person. Billable: about $0.4 per phone found (a miss is free) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. The most expensive operation here, roughly 20x an email lookup, so it suits people the user has already qualified rather than a whole list. start_bulk_job takes an approved list.","params":["lead_id","linkedin_url","first_name","last_name","domain","company","timeout_ms"]},{"name":"start_bulk_job","description":"Submit up to 50 records for asynchronous processing and get a job_id back. Billable at the same per-record rate as the single-record tool, and the whole cost is reserved at submit time: a submitted job keeps running (and charging) even if nobody polls it. Meant for a list the user has approved. get_bulk_job polls it, and a webhook (create_webhook) reports when it finishes.","params":["job_type","items","mode","timeout_ms","confirm_spend_usd"]},{"name":"get_bulk_job","description":"Status and results of a bulk job. Free: this call never spends credits. Polling is free (the work was billed at submit time); a few seconds between polls is enough.","params":["job_type","job_id","timeout_ms"]},{"name":"list_webhooks","description":"List the webhook endpoints registered for bulk-job completion events. Free: this call never spends credits.","params":["timeout_ms"]},{"name":"create_webhook","description":"Register a URL that receives bulk-job completion events, so scheduled or unattended workflows are notified instead of polling. Each event carries the job's results (emails, phone numbers or records) in its body. Free: this call never spends credits.","params":["url","events","secret","timeout_ms"]},{"name":"update_webhook","description":"Change the URL, events or signing secret of a registered webhook. Free: this call never spends credits. A new URL changes where completion events, and the results they carry, are delivered; a new event list changes which events are sent.","params":["id","url","events","secret","timeout_ms"]},{"name":"delete_webhook","description":"Delete a registered webhook; its endpoint stops receiving completion events. Free: this call never spends credits.","params":["id","timeout_ms"]},{"name":"test_webhook","description":"Send a test event to a registered webhook endpoint. Free: this call never spends credits.","params":["id","timeout_ms"]}],"toolsHash":"1072066a2327ec3013104edf78bbd5f501c5178108b8adbaeeaa6cf9e92a067a","wrote":[],"callsAt":"2026-11-16T11:56:24.421Z","calls":[{"tool":"get_balance","ok":false,"ms":6,"bytes":0,"error":"tool reported an error: {\n  \"error\": \"Authorization header is required\",\n  \"status\": null,\n  \"detail\": null\n}"},{"tool":"health","ok":true,"ms":3,"bytes":260},{"tool":"list_webhooks","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: {\n  \"error\": \"Authorization header is required\",\n  \"status\": null,\n  \"detail\": null\n}"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":21,"wrote":0,"callsTried":3,"callsAnswered":1,"callContacts":[]},"history":[{"package":"generect-ultimate-mcp","version":"0.13.2","ranAt":"2026-11-16T11:56:17.853Z","outcome":"started","tools":21,"contacts":0,"flags":0,"serious":0,"toolsHash":"1072066a2327ec3013104edf78bbd5f501c5178108b8adbaeeaa6cf9e92a067a"}],"page":"https://bragproof.smaverk.com/r/generect-ultimate-mcp"}