# Affinda MCP for AI Agents AI Agent Connect

> Affinda MCP lets your AI agent handle heavy lifting for document processing. It pulls structured data from resumes, invoices, and IDs like passports or receipts. Instead of manual data entry, you can just ask your agent to parse a file URL and get the JSON back instantly. It handles the messy stuff so you don't have to.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_yFIGwqYMwMGDzAPprZCYJ7ppMcFfsuopOw4ljSHA/ai-agent-connect
- **Tags:** document-parsing, data-extraction, resume-processing, invoice-processing, idp, structured-data

## Description

Affinda lets you turn messy PDFs and images into structured data. You're likely dealing with a mountain of files that need to be turned into actual information. Maybe it's a stack of resumes from a new hiring cycle or a pile of invoices from a vendor that won't follow your formatting. Usually, this means manual typing or brittle scripts that break the moment a layout changes. Affinda changes that by letting your AI agent do the extraction for you. You can point your agent at a document URL, and it handles the parsing, turning a messy scan into a clean JSON object you can actually use. It's about moving from "looking at a file" to "having the data." When you use this Connector through the Vinkius catalog, your agent gains the ability to audit your entire workspace, check which document types your account supports, and track the status of every file in real-time. It's a way to bridge the gap between unstructured paperwork and a clean database without the headache of manual entry. Whether you're processing thousands of records or just a few complex ones, this connector ensures the data comes out clean and ready for your next step. You don't have to worry about weird formatting or missing fields. Your agent handles the heavy lifting of the data extraction while you focus on the high-level decisions. This makes it a go-to for anyone who needs to get data out of paper as fast as possible.

## Tools

### list_documents
See every parsed document in your workspace along with its current processing status. This helps you keep track of large batches in one view.

### create_document
Upload a PDF or image via a public URL to get a high-accuracy JSON extraction. It handles the parsing and waits for the result.

### get_document
Grab the full JSON data and status for a specific document you've already processed. Use this to pull exact fields into your database.

### list_workspaces
View all the different workspace containers in your Affinda account. This makes it easy to organize different projects or clients.

### list_document_types
Check exactly which models like Resume, Invoice, or Passport your account supports. Use this to verify your available parsing options.

## Prompt Examples

**Prompt:** 
```
List all documents in my 'Pending Invoices' workspace.
```

**Response:** 
```
I've retrieved the documents from the 'Pending Invoices' workspace. Here is the current status:

| Document ID | Status | Type |
| :--- | :--- | :--- |
| INV-9920 | Completed | Invoice |
| INV-9921 | Processing | Invoice |
| INV-9922 | Pending | Invoice |

Would you like me to pull the JSON details for any of these?
```

**Prompt:** 
```
Parse this resume: https://example.com/cv.pdf using the resume model.
```

**Response:** 
```
I've started the parsing process for that resume. 

**Extraction Complete!**

Here is the structured data for the candidate:
- **Name:** John Doe
- **Experience:** 5 years in Python Development
- **Education:** B.S. in Computer Science
- **Key Skills:** Django, AWS, SQL, Docker

Would you like me to save this to your recruitment database?
```

**Prompt:** 
```
What models can I use for document parsing?
```

**Response:** 
```
I've checked your account settings. You currently have access to the following models:

*   **Resume**
*   **Invoice**
*   **Receipt**
*   **Passport**

Which of these would you like to use first?
```

## Capabilities

### Extract JSON from resumes
Turn PDF resumes into structured data for your database.

### Parse invoice data from images
Get clean totals and vendor info from scanned invoice photos.

### Fetch structured ID details
Pull specific fields from passports and other identity documents.

### Audit workspace document status
Check the processing status of every file in your workspace.

### List supported document models
See which document types your account is currently set up to parse.

### Manage workspace containers
Organize your documents into different workspaces for better control.

## Use Cases

### Resume Screening
An HR lead asks the agent to parse 50 resumes and list candidates with over 5 years of Python experience using create_document.

### Invoice Auditing
A finance user asks the agent to find all invoices in a workspace that are still in a pending status using list_documents.

### Identity Verification
A compliance officer asks the agent to extract passport numbers from a batch of uploaded ID images using create_document.

### Workspace Cleanup
An ops manager asks the agent to list all workspaces to see where documents are being stored using list_workspaces.

## Benefits

- Stop manual data entry by using create_document to turn PDFs into JSON.
- Keep your files organized by using list_workspaces to manage different projects.
- Get instant status updates on large batches with list_documents.
- Verify your account capabilities quickly using list_document_types.
- Access specific details on demand with get_document for deep-dive audits.

## How It Works

The bottom line is you turn messy files into usable data without typing a single character.

1. Connect your Affinda Bearer Token to the Connector.
2. Provide the AI agent with a public URL for the document you need to parse.
3. Get a structured JSON response with all the extracted fields ready for your database.

## Frequently Asked Questions

**Can Affinda MCP help with my hiring process?**
Yes. It lets your AI agent parse resumes into structured data, making it much faster to screen candidates and extract key skills without opening every file.

**How does Affinda MCP handle different types of invoices?**
It supports various invoice formats by extracting key fields like vendor names, totals, and dates into a clean JSON format for your records.

**Can I use Affinda MCP to verify IDs for compliance?**
Absolutely. You can use it to pull specific details from identity documents like passports, which helps automate KYC and risk assessment workflows.

**Does Affinda MCP support high-volume document parsing?**
Yes, it's designed to handle large volumes of documents, allowing you to track the status of entire batches and get structured data back quickly.

**How do I check the status of a document I just uploaded?**
You can ask your agent to check your workspace status. It will retrieve the latest processing updates for all your recent uploads in one go.

**What kind of files can Affinda MCP process?**
It can process various file types including PDFs and images of resumes, invoices, receipts, and identity documents like passports.

**How do I find my Affinda API Key?**
Log in to Affinda, click on your profile avatar, and go to **Settings** > **API Keys**. You can generate a new token there. Remember to copy it immediately, as it is only shown once.

**What document types are supported?**
Affinda supports dozens of specialized models including Resumes, Invoices, Receipts, Passports, Driver Licenses, and Purchase Orders. Use the `list_document_types` tool to see the full list for your account.

**Can I parse a document via a public URL?**
Yes! The `create_document` tool accepts a `url` parameter. Simply provide the direct link to the PDF or image, and Affinda will retrieve and parse it automatically.