# AbstractAPI MCP for AI Agents MCP

> AbstractAPI equips your AI agent with critical data validation and enrichment tools, moving beyond simple text generation. You can instantly validate emails against MX records, perform real-time IP geolocation for full geographic context, and pull corporate details like employee count or industry from a domain name. It's designed to solve the messy problem of dirty, incomplete business data directly within your AI conversation.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** data-enrichment, email-validation, geolocation, phone-validation, data-hygiene, rest-api

## Description

Building clean datasets used to involve multiple tools: one service for email checking, another for IP lookups, and yet another for company records. AbstractAPI changes that process entirely. Now you can connect this MCP through Vinkius and let your agent handle all the data hygiene automatically. Instead of running disjointed scripts or manually pasting addresses into different web forms, you simply ask your AI client to enrich a list. Your agent will check email deliverability, validate if an international phone number is active, and even find out what country a specific IP address belongs to—all in one go. It's built for operational teams who need accurate records immediately, whether they are trying to build clean marketing lists or debugging geographic routing errors. It lets you stop worrying about data quality and start focusing on the insights.

## Tools

### geolocate_ip
Pass an IPv4 or IPv6 address to retrieve the country, city, ISP, timezone, and currency data associated with that IP.

### validate_email
Checks an email address for deliverability by analyzing MX records and performing SMTP verification to confirm if the inbox exists.

### validate_phone
Takes a full phone number with its country code and returns details on the carrier, line type (mobile or landline), and general validity status.

### enrich_company
Inputs a domain name to pull core company data, including the official industry, estimated employee count, and primary LinkedIn profile link.

### exchange_rate
Retrieves either real-time or historical currency exchange rates between two specified base and target currencies.

### validate_vat
Checks an EU VAT number, requiring the country prefix, to confirm its validity, associated company name, and registered legal address for billing purposes.

### list_holidays
Retrieves a list of official local and national public holidays for any given ISO country code and year.

### get_timezone
Provides the timezone name, UTC offset, and current local time when supplied with a city name or coordinates.

### generate_avatar
Creates a URL for an initials-based avatar image placeholder using only a person's full name.

### website_screenshot
Generates and returns a permanent, shareable URL that renders a full-page screenshot of the specified target website.

## Prompt Examples

**Prompt:** 
```
Check this email: sales@exampleco.com. Is it safe to send an account update to them?
```

**Response:** 
```
**Email Analysis Report:**
*   **Status:** Deliverable
*   **MX Records Check:** Passed (Confirmed valid servers)
*   **SMTP Verification:** Successful handshaking.
The email address is confirmed as active and ready for sending. You should have a high deliverability score, minimizing bounce risk.
```

**Prompt:** 
```
What's the company behind techsolutionsinc.net? I need their industry and employee count.
```

**Response:** 
```
**Company Profile: TechSolutionsInc**
*   **Industry:** Software & SaaS
*   **Headcount Estimate:** 800 - 1,500 employees globally.
*   **LinkedIn Link:** [link provided]
This confirms they are a sizable player in the software sector. You can use this data to tailor your pitch accordingly.
```

**Prompt:** 
```
Find out details about the IP address 203.178.4.15.
```

**Response:** 
```
**IP Geolocation Data:**
*   **Country:** United States
*   **City:** Seattle
*   **Timezone:** America/Los_Angeles
*   **ISP:** Comcast Cable Communications, LLC
*   **Currency:** USD
This node is located in the Pacific Northwest and operates on local US time.
```

## Capabilities

### Validate Contact Information
Checks if an email is deliverable by examining MX records and verifying the domain's structure, or validates a phone number to confirm its carrier and line type.

### Determine Location from IP Address
Takes any IPv4 or IPv6 address and returns precise details, including country, city, ISP, timezone, and local currency data.

### Enrich Company Profile Data
Uses a domain name to pull structured corporate information such as the company's official industry, estimated employee count, and main LinkedIn page link.

### Handle Global Business Operations
Performs specialized checks like validating EU VAT numbers for billing or fetching real-time currency exchange rates between two currencies.

### Generate Media Assets
Creates placeholder avatar images from a name's initials, or renders full web page screenshots based on a target URL.

## Use Cases

### Cleaning up scraped sales lists.
A sales team needs to clean 5,000 contacts found online. They ask their agent to validate all emails using validate_email and then use enrich_company on the associated domains to ensure they're targeting viable businesses.

### Debugging regional routing errors.
A developer finds an error log pointing to a specific IP address. They ask their agent to geolocate_ip, immediately confirming it belongs to a certain region and providing the correct local currency for debugging parameters.

### Setting up international billing.
A finance operator needs to process an invoice from Germany. They use validate_vat on the VAT number and then check the exchange_rate tool to ensure the final payment amount is calculated correctly in USD.

### Researching a new competitor's footprint.
A market researcher finds a competitor's website. They ask their agent to enrich_company on the domain, getting the industry and employee count, then use website_screenshot to capture visual proof of key pages.

## Benefits

- Stop sending emails to dead accounts. The validate_email tool checks deliverability using MX records, saving your sender reputation.
- Build cleaner lead lists instantly. Use enrich_company to pull industry, headcount, and LinkedIn links directly from a domain name you scraped.
- Eliminate geographical guesswork. Pass an IP address through the geolocate_ip tool to confirm the country, timezone, and local currency for billing accuracy.
- Manage international payments better. The exchange_rate tool provides real-time or historical rates so your agent can calculate costs accurately in any foreign currency.
- Simplify complex data capture. You don't need separate tools; one prompt lets you check both a phone number (validate_phone) and the company behind it (enrich_company).
- Improve documentation. Use website_screenshot to generate visual proof of web pages without needing browser automation scripts.

## How It Works

The bottom line is that your AI client treats this data enrichment process like a built-in function, allowing complex validation tasks through simple conversation.

1. Connect your AbstractAPI account to Vinkius and link the MCP credentials using your specific API key.
2. Your AI client sends a natural language prompt requesting data actions, for instance, 'What country is 8.8.8.8 in?'
3. The agent uses the appropriate tool within the MCP (like geolocate_ip) to fetch structured results and presents them back to you as plain text.

## Frequently Asked Questions

**How can AbstractAPI help me clean up my list of scraped emails?**
AbstractAPI validates your emails instantly, confirming deliverability using MX records and SMTP checks. You get a clear report showing which addresses are safe to send to, saving you time and protecting your sender reputation.

**What kind of data can I get about a company just from its website domain?**
You can use AbstractAPI's enrichment tools on the domain. It returns key business metrics like the industry sector, estimated employee count, and official LinkedIn profile link.

**Is geolocate_ip reliable for knowing where a user actually is?**
The MCP provides geolocation data based on the IP address range. It gives you the best available information—like country, city, ISP, and timezone—which is extremely useful for setting up region-specific marketing campaigns.

**Does AbstractAPI help me with international billing or VAT numbers?**
Yes, it validates EU VAT numbers. You simply provide the number and country prefix, and the MCP confirms if it's valid and provides the registered legal address for accurate B2B invoicing.

**Can I use AbstractAPI to generate images or capture web pages?**
Absolutely. It includes tools that can create placeholder avatars from a name, or render full-page website screenshots into permanent URLs, which is great for documentation and proofing.