SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

Affinda MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Affinda MCP or direct API to extract key data from documents, parse resumes, process invoices, and automate document workflows through natural language.

Get started for freeGet a demo
Affinda logoAffinda
Api Key

Affinda is an AI-powered document processing platform that automates data extraction from resumes, invoices, and more. It streamlines document-heavy workflows by turning files into structured, actionable data.

105 Tools

Try Affinda now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Affinda
Try asking
TOOLS

Supported Tools

Every Affinda action and event your agent gets out of the box.

Add Tag to Documents

Tool to add a tag to multiple documents in a single operation.

Batch Update Annotations

Batch update multiple document annotations in a single API call.

Create API User

Tool to create a new API user within an organization.

Batch Create Annotations

Batch create multiple document annotations in a single API call.

Create Collection

Tool to create a new collection.

Create Data Field For Collection

Tool to create a data field for a collection along with a new data point.

Create Data Source

Tool to create a custom mapping data source.

Create Data Source Value

Tool to add a new value to a mapping data source.

Create Document

Upload a document to Affinda for parsing and data extraction.

Create Document Type

Tool to create a new document type in the specified organization.

Create Extractor

Tool to create a new extractor.

Create Document from Data

Create a document from structured resume or job description data for Search & Match.

Create Index

Tool to create a new index for search and match functionality.

Create Invitation

Tool to create a new organization invitation.

Create Job Description Search

Search through parsed job descriptions using custom criteria or resume matching.

Create Job Description Search Embed URL

Tool to create and return a signed URL for the embeddable job description search tool.

Create Organization

Tool to create a new organization.

Create RESTHook Subscription

Tool to create a new RESTHook subscription.

Create Resume Search

Tool to search through parsed resumes using three methods: match to a job description, match to a resume, or custom criteria.

Create Resume Search Embed URL

Tool to create and return a signed URL for the embeddable resume search tool.

Create Tag

Creates a new tag in the specified workspace.

Create Validation Result

Create a validation result for document annotations in Affinda.

Batch Create Validation Results

Batch create multiple validation results for document annotations in a single API call.

Create Workspace

Tool to create a new workspace.

Create Workspace Membership

Tool to add a user to a workspace by creating a membership.

Batch Delete Annotations

Batch delete multiple document annotations in a single API call.

Delete Collection

Permanently delete a collection from Affinda by its identifier.

Delete Data Source

Permanently delete a mapping data source from the database by its identifier.

Delete Data Source Value

Tool to delete a specific value from a mapping data source.

Delete Document

Tool to delete a specific document by its ID.

Delete Document Type

Tool to permanently delete a document type by its identifier.

Delete Index

Tool to permanently delete an index from Affinda by its name.

Delete Invitation

Tool to delete an invitation by its identifier.

Delete Organization

Permanently deletes an organization from Affinda.

Delete Resthook Subscription

Tool to delete a specific resthook subscription by ID.

Delete Tag

Permanently delete a tag from Affinda by its ID.

Delete Validation Results

Delete multiple validation results in a single API call.

Delete Workspace

Tool to delete a specific workspace by its ID.

Delete Workspace Membership

Tool to remove a user from a workspace by membership ID.

Get All API Users

Tool to retrieve a list of all API users.

Get All Document Splitters

Tool to get a list of all document splitters.

Get All Invitations

Tool to retrieve all invitations you created or sent to you.

Get Organization Memberships

Retrieve all organization memberships across the account.

Get Tags

Tool to list all tags.

Get All Validation Results

Tool to list validation results for documents.

Get Workspace Memberships

Retrieve all workspace memberships across the account.

Get Annotations

Retrieves all annotations for a specific document.

Get Collection

Tool to retrieve details of a specific collection by its ID.

Get Collections

Tool to retrieve a list of all collections.

Get Data Source

Tool to retrieve details of a specific mapping data source by its identifier.

Get Data Source Value

Tool to retrieve a specific value from a mapping data source.

Get Data Source Values

Tool to retrieve all values from a mapping data source.

Get Document

Retrieve full details and parsed data for a specific document by its identifier.

Get Document Redacted

Tool to retrieve the redacted version of a document as a PDF file.

Get Documents

Tool to retrieve a list of all documents.

Get Document Splitter

Tool to retrieve details of a specific document splitter by its identifier.

Get Document Type

Tool to retrieve details of a specific document type by its ID.

Get Document Type JSON Schema

Tool to generate a JSON schema from a document type by its identifier.

Get Document Type Pydantic Models

Tool to generate Pydantic model code from a document type's schema.

Get Document Types

Retrieve all document types accessible to the authenticated user.

Get Extractor

Tool to retrieve detailed information about a specific extractor by its identifier.

Get Extractors

Retrieve all extractors available for an organization.

Get Index Documents

Tool to retrieve all indexed documents for a specific index.

Get Invitation

Tool to retrieve details of a specific organization invitation by its identifier.

Get Job Description Search Config

Tool to get the configuration for the logged in user's embeddable job description search tool.

Get Mapping

Tool to retrieve a specific mapping by its identifier.

Get Organization

Tool to retrieve details of a specific organization by its ID.

Get Organization Membership

Tool to retrieve details of a specific organization membership by its ID.

Get Organizations

Retrieves all organizations accessible to the authenticated user.

Get Resthook Subscription

Tool to retrieve details of a specific resthook subscription by its ID.

Get RESTHook Subscriptions

Tool to retrieve a list of all RESTHook subscriptions.

Get Tag

Tool to retrieve details of a specific tag by its ID.

Get Usage by Workspace

Retrieves monthly document processing usage statistics for a specific workspace.

Get Workspace

Tool to retrieve details of a specific workspace by its ID.

Get Workspace Membership

Tool to retrieve details of a specific workspace membership by its ID.

Get Workspaces

Tool to retrieve a list of all workspaces.

List Data Points

Tool to retrieve all data points.

List Data Sources

Tool to retrieve the list of all custom mapping data sources.

List Indexes

Tool to retrieve a list of all search indexes.

List Mappings

Tool to retrieve the list of all custom data mappings.

List Occupation Groups

Tool to retrieve the list of searchable occupation groups.

List Resume Search Config

Tool to get the configuration for the logged in user's embeddable resume search tool.

List Resume Search Job Title Suggestions

Tool to get job title suggestions based on provided job title(s).

List Resume Search Skill Suggestions

Tool to get skill suggestions based on provided skills.

Remove Tag from Documents

Remove a tag from multiple documents in a single batch operation.

Replace Data Source Values

Tool to completely replace all values in a mapping data source.

Split Document Pages

Split a document into multiple documents by dividing its pages.

Update Annotation

Tool to update data of a single annotation in Affinda.

Update Collection

Tool to update specific fields of a collection.

Update Data Field For Collection

Tool to update a data field configuration for a collection's data point.

Update Data Source Value

Tool to update an existing value in a mapping data source.

Update Document

Tool to update specific fields of a document.

Update Document Data

Update parsed data for a resume or job description document in Affinda.

Update Document Type

Tool to update a document type by its identifier.

Update Extractor

Tool to update specific fields of an extractor.

Update Index

Tool to update the name of an existing search index.

Update Invitation

Tool to update an organization invitation's role.

Update Job Description Search Config

Tool to update the configuration for the logged in user's embeddable job description search tool.

Update Mapping

Tool to update a specific mapping's settings.

Update Organization

Tool to update specific fields of an organization.

Update Organization Membership

Tool to update an organization membership's role.

Update RESTHook Subscription

Tool to update an existing RESTHook subscription.

Update Resume Search Config

Tool to update the configuration for the logged in user's embeddable resume search tool.

Update Tag

Tool to update data of a tag.

Update Workspace

Tool to update specific fields of a workspace.

SETUP GUIDE

Connect Affinda MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["affinda"],
  mcp: true,
});
Create a session scoped to Affinda and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Extract key fields from uploaded invoice PDF",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Affinda request
SETUP GUIDE

Connect Affinda API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["affinda"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Affinda
3

Run Affinda tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Extract key fields from uploaded invoice PDF" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Affinda tool calls through the session, and print the final answer

Why Use Composio?

AI Native Affinda Integration

  • Supports both Affinda MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Affinda data

Managed Auth

  • Built-in API key handling with secure storage by Composio
  • Central place to manage, scope, and revoke Affinda access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Affinda
  • Scoped, least privilege access to Affinda resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Affinda with any AI Agent Framework

Choose a Framework you want to connect Affinda with

Claude Code logo

Claude Code

Use Affinda MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Affinda MCP with Claude Cowork

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Affinda MCP with OpenAI Agents SDK

Claude Agents SDK logo

Claude Agents SDK

Use Affinda MCP with Claude Agents SDK

Codex logo

Codex

Use Affinda MCP with Codex

OpenClaw logo

OpenClaw

Use Affinda MCP with OpenClaw

Hermes logo

Hermes

Use Affinda MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Affinda MCP with Atomic Agent

Google ADK logo

Google ADK

Use Affinda MCP with Google ADK

Langchain logo

Langchain

Use Affinda MCP with Langchain

AI SDK logo

AI SDK

Use Affinda MCP with AI SDK

Mastra AI logo

Mastra AI

Use Affinda MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Affinda MCP with LlamaIndex

CrewAI logo

CrewAI

Use Affinda MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Affinda MCP with Pydantic AI

Autogen logo

Autogen

Use Affinda MCP with Autogen

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Yes, Affinda requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Yes. Composio is SOC 2 Type II compliant and is built to keep your Affinda connection and credentials secure. OAuth tokens and API keys are encrypted, and sensitive customer data is protected at rest and in transit.

Composio also undergoes independent security testing and continuously monitors its systems for security threats. You can review the latest reports and policies in the Composio Trust Center.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Create the key in your Affinda account settings, then paste it once on Composio's connection page. Composio stores it encrypted and uses it only for the Affinda actions your agent runs. Nobody else in your workspace can read it, and you can revoke it inside Affinda at any time.

When you connect a Affinda account through Composio, every action runs under that account, so anything the agent creates, sends, or changes shows up in Affinda as done by you. Keep an approval step in your prompt for actions with side effects, such as sending or deleting, and have the agent draft first.

Whatever the credentials you connect allow inside Affinda. If Affinda lets you scope a key to specific permissions, create a scoped one so the agent can only do what you intend. You can revoke the key inside Affinda at any time.

Yes. Composio supports multiple connected accounts for the same app, and that works in Claude, ChatGPT, or any other assistant you connect through Composio. Give each Affinda connection a name such as work or personal, and the assistant uses the one you mention in the request. Each account keeps its own credentials and nothing is merged.

The connection stops working the moment Affinda rejects the old key. Create a new key in Affinda and reconnect the account from the Composio dashboard or by asking your agent to reconnect Affinda. Nothing else changes.

Composio's free Hobby plan includes 100,000 tool calls per month with no credit card, which covers most personal Affinda use. Paid plans add higher limits and team features. Your Affinda plan and its API limits still apply as usual.

Built-in connectors usually give one AI access to a limited set of apps. Many people use Composio because it lets their AI connect to more apps than it normally supports, or connect to multiple accounts for the same app (e.g. connect Claude to multiple Affinda accounts).

With Composio, you connect Affinda once and then use it across different AI assistants without setting it up separately in each one. Connect your apps to Composio once, then connect Composio to whichever AI you use, whether that's Claude, ChatGPT, Hermes, or your own custom assistant.

Start with Affinda.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Affinda tool your agent needs.Free to start.

Start building