How do I run lead enrichment with an AI agent?
Give your agent a list of LinkedIn profiles, get a free GTMMAXING quote, then run enrichment with a credit limit. Use MCP from an assistant, the gtm CLI for local CSV files, or the REST API for a job running in your own app.
Prepare the input and pick an interface
Start with a small sample and keep each profile URL next to its source record. An email-only lookup from a profile costs 1 credit for a new email found. Misses and successful repeats on your account are free. Quote mobile enrichment and mailbox verification separately if you need either.
MCP for chat
Connect your assistant to https://gtmmaxing.com/mcp. Paste the profiles into a chat, then send this instruction.
Use gtm_find_contacts to quote email-only enrichment for these profiles.
Show the quote before running. Use the limit I approve and fetch the full CSV. CLI for a CSV
Use a CSV with a url column containing LinkedIn profile URLs. Install the CLI, sign in with the matching code, then price the file.
npm install -g gtmmaxing
gtm login
gtm contacts --file leads.csv --dry-run Once the budget is approved, replace APPROVED_BUDGET with that number and run the batch.
gtm contacts --file leads.csv --max-credits APPROVED_BUDGET --out enriched.csv REST API for an automated job
Create a token in API keys and set GTM_API_KEY in your runtime’s secret store. This request quotes one profile.
curl -sS https://api.gtmmaxing.com/v1/agent/tools/gtm_find_contacts \
-H "Authorization: Bearer $GTM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"people":["satyanadella"],"find":["email"],"dry_run":true,"max_credits":0}' For the paid request, remove dry_run, set max_credits to the approved budget, and add an idempotency_key from your job record. If the response is running, call gtm_results with the run ID. The API quickstart shows both request and response shapes.
Set a cap for recurring work
Review each connected agent’s cap in Usage. Use the smaller of the remaining budget for the job and the limit approved for this batch. For repeated jobs, keep a shared budget across batches and stop when it runs out.
Frequently asked questions
What is the difference between a quote and a spending cap?
A quote estimates what the job could cost. max_credits limits one paid call. The cap you set for the connected agent or token limits its spending across calls during the configured period. The available prepaid balance also applies.
Can an agent enrich a list with just names and companies?
Yes. GTMMAXING can resolve names and companies to profiles. Quote that workflow separately because profile resolution can use additional credits.
How do I retry an API request after a timeout?
Resend the same request with the same idempotency_key. A replay retrieves the saved run instead of starting another paid call. Use a new key for a different job.