# Affinda MCP for AI Agents MCP

> Affinda lets your AI client automatically extract structured data from complex documents like resumes, invoices, IDs, and receipts. Instead of manually reading PDFs or images for key details, this MCP parses them into clean JSON format. You can audit document statuses across multiple workspaces and manage the specific extraction models supported by your account, making record keeping effortless.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** document-parsing, data-extraction, resume-processing, invoice-processing, idp, structured-data

## Description

When you connect Affinda through your AI client, you gain powerful intelligent document processing (IDP) capabilities right inside your chat window or IDE. It takes messy files—like a stack of paper invoices or dozens of candidate resumes—and turns them into organized, usable data structures. Your agent doesn't just read the documents; it understands them. You can upload an image of an ID and immediately get verifiable details like names and numbers. Need to track status? You can list all your active workspaces and see exactly where every document stands in the parsing queue. The bottom line is, you stop wasting time copy-pasting data from one file into a spreadsheet. Just let your agent handle the extraction. Since Vinkius hosts over 4,000 MCPs, connecting here gives you immediate access to this powerful tool alongside countless others for every part of your business.

## Tools

### list_documents
Retrieves a list of all processed documents in an Affinda workspace, including their processing status.

### get_document
Fetches the complete structured JSON data and current status for one specific processed document.

### create_document
Uploads a PDF or image file via its public URL, triggering high-accuracy JSON extraction into Affinda.

### list_workspaces
Gives you an overview of every container workspace available within your Affinda account.

### list_document_types
Retrieves a list detailing all document parsing models supported by your account, such as Resume or Passport.

## Prompt Examples

**Prompt:** 
```
I need to process 15 candidate resumes for the Engineering team. Can you handle the whole batch?
```

**Response:** 
```
**📄 Batch Parsing Complete**

Successfully processed 15 documents across three workspaces.

*   **Candidate A:** Skills: Python, SQL (High). Experience: 7 years.
*   **Candidate B:** Skills: Java, AWS. Experience: 4 years.
*   **Candidate C:** Status Check: Parsing failed due to poor image quality. Review needed.
```

**Prompt:** 
```
What's the status of the last three invoices I uploaded? I need to confirm they are ready for Accounts Payable.
```

**Response:** 
```
**✅ Invoice Status Report**

| Document ID | File Type | Status | Last Updated |
| :---: | :---: | :---: | :---: |
| inv-7890 | PDF | **Processed** | 2 minutes ago |
| inv-7891 | JPG | **Processing** | In progress |
| inv-7892 | PDF | **Error** | Missing Vendor ID. Needs review. |
```

**Prompt:** 
```
List all the kinds of documents this system can read, like invoices or IDs.
```

**Response:** 
```
**Supported Document Models:**

Affinda supports high-accuracy parsing for several critical document types:

*   🧾 **Invoices** (Extracts vendor, amount, line items).
*   🆔 **Passports** (Reads name, ID number, expiry date).
*   📄 **Resumes** (Pulls education history, job titles, and skills).
*   💵 **Receipts** (Captures transaction details quickly).
```

## Capabilities

### Parse documents from URLs or uploads
Send a PDF or image link and initiate high-accuracy JSON extraction for structured data.

### List all document workspaces
Retrieve an overview of every dedicated workspace where Affinda stores processed files.

### Audit documents within a workspace
Get a list of all parsed documents in a specific space, along with their current processing status.

### Check the status and metadata of one file
Retrieve the full JSON data, technical details, and current parsing status for a single document.

### Identify supported document models
List exactly which types of documents your account can process (like Resume or Invoice).

## Use Cases

### Auditing a batch of vendor invoices
An accounts payable clerk needs to verify if 50 recent invoices were processed correctly. Instead of downloading and checking each one, they ask the agent to `list_documents` in the 'AP' workspace, confirming status for all files before payment runs.

### Onboarding a new hiring class
An HR manager needs to process 20 resumes from recent applicants. They use the agent to `create_document` with all URLs at once, and then ask for status checks on every file using `list_documents`, ensuring no candidate data was missed.

### Compliance audit of identity records
A compliance officer needs to confirm which types of IDs the company accepts. They use the agent's ability to check supported models (`list_document_types`), confirming that both Passport and Driver's License are available for parsing.

### Checking document data integrity
A finance analyst receives a tricky invoice PDF. Instead of just trusting the surface numbers, they use the agent to `get_document` on the parsed file, retrieving the full JSON structure to verify every single extracted field.

## Benefits

- Automate candidate screening: Use the `create_document` tool to upload resumes, letting your agent pull out structured metadata instantly.
- Maintain full oversight: The `list_workspaces` capability lets you see all document containers in one place, so nothing gets lost.
- Verify data quality: Check processing errors or missing fields by using the `get_document` tool to audit any file's raw JSON output.
- Keep track of volume: Quickly run through all files in a workspace with `list_documents`, knowing exactly how many documents you’ve processed.
- Manage model scope: Use `list_document_types` when onboarding new teams; it tells you exactly which parsing models, like Receipt or Invoice, your account supports.

## How It Works

The bottom line is, you use natural conversation instead of navigating separate web dashboards to manage and extract data from all your files.

1. Subscribe to this MCP and provide your Affinda Bearer Token credentials.
2. Your AI client connects, giving it permission to interact with your document workspaces.
3. You simply tell your agent what you need—for example, 'Check the status of all invoices in the Accounts Payable workspace'—and get the structured data back.

## Frequently Asked Questions

**How do I find all my different workspaces within Affinda MCP using AI agents?**
The MCP provides a simple tool to list all container workspaces, giving you an immediate overview of every dedicated collection point for your documents and processed files.

**Can the Affinda MCP process invoices that have complex layouts or multiple line items?**
Yes. It is designed for financial data extraction. When you use it, your agent pulls structured JSON detailing vendor information, amounts, and specific line items.

**If I upload a batch of files, how do I know if they all finished processing?**
You don't have to guess. You can use the MCP to list and audit every document in your workspace, seeing its real-time status—whether it’s pending or complete.

**Is Affinda useful for an HR team needing to process many resumes?**
Absolutely. The platform is built specifically for that. You can upload entire batches of resume PDFs and have your agent pull out structured metadata like job history and skills automatically.