· 9 min read · MCP
Claude / Cursor agents: Calling a contact lookup MCP endpoint
Claude and Cursor agents calling a contact lookup MCP endpoint: tool calls instead of scrapers – same credits as REST.
Claude, Cursor, and similar agents should call a contact lookup tool – not scrape LinkedIn HTML. Invenitor exposes that tool over MCP (and the same find over REST): profile URL in, email/phone/links out when we have them. A people search and lookup API, not a sales cloud.
Claude / Cursor setup shape (high level)
- Point the agent or IDE at Invenitor’s MCP server config (see /mcp.md).
- Authenticate with the same API key pattern you use for REST (/docs).
- Prompt: “Look up contacts for these profile URLs.
- Persist outcomes in your sheet or CRM with provenance.
Why MCP beats scraping for outreach agents
Scrapers break, violate product terms, and tempt agents to hallucinate when HTML is thin.
Category: What a Contact Lookup API Actually Does. Hub: LinkedIn or GitHub Profile URL → Contact Lookup API. GitHub rail: GitHub Profile URL Contact Lookup. Definition: What Is a LinkedIn Profile URL Lookup?.
Credits when agents call lookup
Agents share the workspace credit pool. 1 credit only when we return an email, a phone, or both. Timeouts and errors do not spend.
Commercial: /pricing. PAYG: Pay-As-You-Go Contact APIs.
Prompt patterns that stay honest
- “Fill email/phone columns only from tool results.”
- “Prefer person profile URLs; reject company pages.”
- “Do not construct emails from name + company domain.”
Common failure modes
- Keys pasted into chat logs.
- Looking up search URLs or company pages.
- Bundling outreach sequencing into the lookup tool (wrong layer).
What should you do next?
Keep REST in /docs as the twin. Buy packs on /pricing when free credits are done. Agents welcome – scrapers are a detour.
REST twin and product packaging
Ship MCP for agents and REST for product backends with one found-only billing rule. Product teams: optional lookup module, not a CRM. See Global PAYG buyers: US Price Arbitrage.
Tool-call checklist before production agents
Confirm person URLs only. Confirm secrets not in chat. Confirm credit balance vs 30-day expiry on /pricing. Confirm REST twin still works for non-agent paths (/docs). Free-plan contrast: The Hidden Cost of "Free Plan" Enrichment Tools. GitHub: GitHub Profile URL Contact Lookup. Category: What a Contact Lookup API Actually Does.
Why PMs should care about MCP now
Agents are already filling sheets in boutique desks. MCP is how you keep reaching people without turning the agent into a liar. Pair with /mcp.md. PAYG: Pay-As-You-Go Contact APIs.
Questions
Can Claude or Cursor call Invenitor for contact lookup?
Yes – wire the MCP endpoint per /mcp.md. Same find contract as REST.
Should agents scrape LinkedIn instead?
No. Use the lookup tool.
Do agent calls use the same credits as REST?
Yes. 1 credit only when we return an email, a phone, or both. Timeouts and errors do not spend.
Where is the MCP spec?
/mcp.md – pair with /docs for REST.
Can agents look up GitHub profiles?
Yes. Person GitHub profile URLs work on the same find path.
How do I authenticate?
Use your API key as documented in /docs and /mcp.md – store secrets safely.
