Affinda MCP

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'affindamcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Affinda MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'affindamcp_list_organizations',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "affindamcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Affinda MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="affindamcp_list_organizations",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update tag, workspace, validation rule — Rename a tag
• Documents remove tag from, add tag to, reject — Take a tag off one or more documents
• List tags, workspaces, validation rules — List the tags defined in a workspace
• Get document page images, workspace details, workspace — View a document’s pages as rendered images, to see the actual document rather than just OCR text
• Delete tag, validation rule, matching criterion — Delete a tag from its workspace
• Create tag, workspace, validation run — Create a new tag in a workspace

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

affindamcp_add_connection_to_integration#Attach an existing service connection to an integration.2 params▾

Attach an existing service connection to an integration.

NameTypeRequiredDescription

connection_idstringrequiredNo description.

integration_idstringrequiredNo description.

affindamcp_add_tag_to_documents#Apply an existing tag to one or more documents. Use this to label documents — e.g. "tag these three invoices as Urgent". Documents that already carry the tag are unaffected (the operation is idempotent). All documents must belong to the same workspace as the tag. The tag must already exist — find its ID with list_tags or create it first with create_tag.2 params▾

Apply an existing tag to one or more documents. Use this to label documents — e.g. "tag these three invoices as Urgent". Documents that already carry the tag are unaffected (the operation is idempotent). All documents must belong to the same workspace as the tag. The tag must already exist — find its ID with list_tags or create it first with create_tag.

NameTypeRequiredDescription

document_idsarrayrequiredDocuments to tag.

tag_idstringrequiredID of the tag to apply.

affindamcp_archive_documents#Move documents to ``archived`` state.1 param▾

Move documents to ``archived`` state.

NameTypeRequiredDescription

document_idsarrayrequiredNo description.

affindamcp_assign_document_type_to_workspace#Make a document type available for use in a workspace.2 params▾

Make a document type available for use in a workspace.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

workspace_idstringrequiredNo description.

affindamcp_bulk_create_data_source_values#Append many new rows to a data source in one call.2 params▾

Append many new rows to a data source in one call.

NameTypeRequiredDescription

data_source_idstringrequiredNo description.

valuesarrayrequiredNo description.

affindamcp_bulk_create_fields#Create many fields on a document type in one call.3 params▾

Create many fields on a document type in one call.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

fieldsarrayrequiredNo description.

field_group_idstringoptionalNo description.

affindamcp_confirm_documents#Mark documents as validated, moving them from ``review`` to ``validated``.1 param▾

Mark documents as validated, moving them from ``review`` to ``validated``.

NameTypeRequiredDescription

document_idsarrayrequiredNo description.

affindamcp_create_api_token#Create a new long-lived Affinda API key for the current user.0 params▾

Create a new long-lived Affinda API key for the current user.

affindamcp_create_connect_token#Mint an OAuth connect token + URL so the user can authorise a service.1 param▾

Mint an OAuth connect token + URL so the user can authorise a service.

NameTypeRequiredDescription

connection_idstringrequiredNo description.

affindamcp_create_data_source#Create an empty data source (lookup table) in an organization.5 params▾

Create an empty data source (lookup table) in an organization.

NameTypeRequiredDescription

namestringrequiredNo description.

organization_idstringrequiredNo description.

display_propertystringoptionalNo description.

key_propertystringoptionalNo description.

schema_definitionstringoptionalNo description.

affindamcp_create_data_source_value#Add one new row to a data source.2 params▾

Add one new row to a data source.

NameTypeRequiredDescription

data_source_idstringrequiredNo description.

valuestringrequiredNo description.

affindamcp_create_document_type#Create a new document type (extraction template) in an organization.3 params▾

Create a new document type (extraction template) in an organization.

NameTypeRequiredDescription

namestringrequiredNo description.

organization_idstringrequiredNo description.

disable_confirmation_if_validation_rules_failbooleanoptionalNo description.

affindamcp_create_field#Create a single field on a document type.15 params▾

Create a single field on a document type.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

field_typestringrequiredNo description.

labelstringrequiredNo description.

slugstringrequiredNo description.

decimal_placesstringoptionalNo description.

descriptionstringoptionalNo description.

enabledbooleanoptionalNo description.

field_group_idstringoptionalNo description.

manual_entrybooleanoptionalNo description.

mapping_data_source_idstringoptionalNo description.

multiplebooleanoptionalNo description.

no_rectbooleanoptionalNo description.

optionsstringoptionalNo description.

parent_idstringoptionalNo description.

transformation_promptstringoptionalNo description.

affindamcp_create_field_group#Create a field group (heading/section) on a document type.2 params▾

Create a field group (heading/section) on a document type.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

labelstringrequiredNo description.

affindamcp_create_integration#Create a new, empty integration in an organization.3 params▾

Create a new, empty integration in an organization.

NameTypeRequiredDescription

namestringrequiredNo description.

organization_idstringrequiredNo description.

descriptionstringoptionalNo description.

affindamcp_create_matching_criterion#Add a matching criterion to a field with an attached data source.7 params▾

Add a matching criterion to a field with an attached data source.

NameTypeRequiredDescription

data_source_propertystringrequiredNo description.

field_idstringrequiredNo description.

source_field_idstringrequiredNo description.

field_attributestringoptionalNo description.

match_typestringoptionalNo description.

requiredbooleanoptionalNo description.

required_strictbooleanoptionalNo description.

affindamcp_create_recruit_workspace#Create a fully-configured Recruitment workspace in one call.1 param▾

Create a fully-configured Recruitment workspace in one call.

NameTypeRequiredDescription

organization_idstringrequiredNo description.

affindamcp_create_tag#Create a new tag in a workspace. Use this when the user wants a new label to organise documents — e.g. "create an Urgent tag", "add a tag for Q3 invoices". The tag starts with no documents attached; apply it with add_tag_to_documents. Tag names must be unique within a workspace. Check list_tags first if you're unsure whether the tag already exists.2 params▾

Create a new tag in a workspace. Use this when the user wants a new label to organise documents — e.g. "create an Urgent tag", "add a tag for Q3 invoices". The tag starts with no documents attached; apply it with add_tag_to_documents. Tag names must be unique within a workspace. Check list_tags first if you're unsure whether the tag already exists.

NameTypeRequiredDescription

namestringrequiredTag name (e.g. Urgent, Q3 Invoices). Max 256 chars.

workspace_idstringrequiredWorkspace the tag belongs to.

affindamcp_create_validation_rule#Create a validation rule for a document type.5 params▾

Create a validation rule for a document type.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

promptstringrequiredNo description.

enabledbooleanoptionalNo description.

field_idsstringoptionalNo description.

missing_data_optionstringoptionalNo description.

affindamcp_create_validation_run#Run a validation rule against a document and refresh its results.3 params▾

Run a validation rule against a document and refresh its results.

NameTypeRequiredDescription

validation_rule_idstringrequiredNo description.

document_idstringoptionalNo description.

document_type_idstringoptionalNo description.

affindamcp_create_workspace#Create a new workspace with chosen processing settings.9 params▾

Create a new workspace with chosen processing settings.

NameTypeRequiredDescription

namestringrequiredNo description.

organization_idstringrequiredNo description.

document_splitter_idstringoptionalNo description.

enable_document_classificationbooleanoptionalNo description.

enable_document_splittingbooleanoptionalNo description.

model_memory_strategystringoptionalNo description.

ocr_modestringoptionalNo description.

reject_duplicatesbooleanoptionalNo description.

visibilitystringoptionalNo description.

affindamcp_delete_data_source#Delete a data source and every row it contains.1 param▾

Delete a data source and every row it contains.

NameTypeRequiredDescription

data_source_idstringrequiredNo description.

affindamcp_delete_data_source_value#Delete one row from a data source by its key.2 params▾

Delete one row from a data source by its key.

NameTypeRequiredDescription

data_source_idstringrequiredNo description.

keystringrequiredNo description.

affindamcp_delete_document_type#Delete a document type permanently.2 params▾

Delete a document type permanently.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

delete_documentsbooleanoptionalNo description.

affindamcp_delete_field#Delete a single field from a document type.1 param▾

Delete a single field from a document type.

NameTypeRequiredDescription

field_idstringrequiredNo description.

affindamcp_delete_field_group#Delete a field group (heading/section) from a document type.1 param▾

Delete a field group (heading/section) from a document type.

NameTypeRequiredDescription

field_group_idstringrequiredNo description.

affindamcp_delete_integration#Permanently delete an integration.1 param▾

Permanently delete an integration.

NameTypeRequiredDescription

integration_idstringrequiredNo description.

affindamcp_delete_integration_secret#Permanently delete a secret. Removes both the database record and the Lambda environment variable.1 param▾

Permanently delete a secret. Removes both the database record and the Lambda environment variable.

NameTypeRequiredDescription

secret_idstringrequiredNo description.

affindamcp_delete_matching_criterion#Delete a matching criterion from a field.1 param▾

Delete a matching criterion from a field.

NameTypeRequiredDescription

matching_criterion_idstringrequiredNo description.

affindamcp_delete_tag#Delete a tag from its workspace. Use this only when the user explicitly wants the tag gone — e.g. "delete the Urgent tag". The tag is removed from every document that carried it; the documents themselves are untouched. To take the tag off specific documents while keeping it available for others, use remove_tag_from_documents instead.1 param▾

Delete a tag from its workspace. Use this only when the user explicitly wants the tag gone — e.g. "delete the Urgent tag". The tag is removed from every document that carried it; the documents themselves are untouched. To take the tag off specific documents while keeping it available for others, use remove_tag_from_documents instead.

NameTypeRequiredDescription

tag_idstringrequiredID of the tag to delete.

affindamcp_delete_validation_rule#Delete a validation rule from a document type.1 param▾

Delete a validation rule from a document type.

NameTypeRequiredDescription

validation_rule_idstringrequiredNo description.

affindamcp_deploy_integration_version#Snapshot the integration's current code as a new version and deploy it. Call this immediately after every successful ``update_integration`` that changed ``python_code`` — it MUST be the next tool call. Code saved on the integration is not live until deployed, and ``run_integration`` always executes the deployed version, so skipping this step means tests run stale code and real document events still fire the previous version. To roll back a bad deploy, use ``revert_integration_version`` wi...1 param▾

Snapshot the integration's current code as a new version and deploy it. Call this immediately after every successful ``update_integration`` that changed ``python_code`` — it MUST be the next tool call. Code saved on the integration is not live until deployed, and ``run_integration`` always executes the deployed version, so skipping this step means tests run stale code and real document events still fire the previous version. To roll back a bad deploy, use ``revert_integration_version`` wi...

NameTypeRequiredDescription

integration_idstringrequiredNo description.

affindamcp_get_data_source#Get one data source by ID — name, schema, and key/display properties.1 param▾

Get one data source by ID — name, schema, and key/display properties.

NameTypeRequiredDescription

data_source_idstringrequiredNo description.

affindamcp_get_document#Get one document by ID — state, workspace, document type, and basic metadata.1 param▾

Get one document by ID — state, workspace, document type, and basic metadata.

NameTypeRequiredDescription

document_idstringrequiredNo description.

affindamcp_get_document_extraction#Get the extracted data for one document — raw text plus all field values.1 param▾

Get the extracted data for one document — raw text plus all field values.

NameTypeRequiredDescription

document_idstringrequiredNo description.

affindamcp_get_document_page_images#View a document's pages as rendered images, to see the actual document rather than just OCR text. Use this when the visual appearance of a document matters and text alone is ambiguous — layout questions, checkboxes and selection marks, signatures, stamps, handwriting, logos, or diagnosing why extraction misread something. The images show each page as it appears in the document review UI. With show_annotations, the extracted annotations are drawn on top of each page as colored rectangles tagged with their field slug — use this to check where a value was read from (wrong instance picked, value attributed to the wrong field, table rows/columns mapped incorrectly). On dense documents, pass field_slugs to only draw the fields you are debugging (a table's slug also draws its cells). Images are expensive in tokens — request only the pages you need, at most 5 per call. For extracted values and raw text, use get_document_extraction instead; only reach for images when text output isn't enough.4 params▾

View a document's pages as rendered images, to see the actual document rather than just OCR text. Use this when the visual appearance of a document matters and text alone is ambiguous — layout questions, checkboxes and selection marks, signatures, stamps, handwriting, logos, or diagnosing why extraction misread something. The images show each page as it appears in the document review UI. With show_annotations, the extracted annotations are drawn on top of each page as colored rectangles tagged with their field slug — use this to check where a value was read from (wrong instance picked, value attributed to the wrong field, table rows/columns mapped incorrectly). On dense documents, pass field_slugs to only draw the fields you are debugging (a table's slug also draws its cells). Images are expensive in tokens — request only the pages you need, at most 5 per call. For extracted values and raw text, use get_document_extraction instead; only reach for images when text output isn't enough.

NameTypeRequiredDescription

document_idstringrequiredID of the document to view.

field_slugsarrayoptionalOnly draw annotations for these field slugs (implies show_annotations). Omit to draw all annotated fields.

page_indicesarrayoptionalZero-based page indices to fetch (e.g. [0] for the first page). Omit to get the first 5 pages. Request at most 5 pages per call.

show_annotationsbooleanoptionalDraw the extracted annotations on the page images as colored rectangles labelled with their field slug.

affindamcp_get_document_type#Get one document type by ID — name, organization, and counts only.1 param▾

Get one document type by ID — name, organization, and counts only.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

affindamcp_get_document_type_details#Get a document type's full configuration — settings + counts.1 param▾

Get a document type's full configuration — settings + counts.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

affindamcp_get_field#Get one field by ID — full settings, formatter, and relationships.1 param▾

Get one field by ID — full settings, formatter, and relationships.

NameTypeRequiredDescription

field_idstringrequiredNo description.

affindamcp_get_field_group#Get one field group by ID — label, position, parent document type.1 param▾

Get one field group by ID — label, position, parent document type.

NameTypeRequiredDescription

field_group_idstringrequiredNo description.

affindamcp_get_integration#Get one integration by ID — full configuration, code, and connections.1 param▾

Get one integration by ID — full configuration, code, and connections.

NameTypeRequiredDescription

integration_idstringrequiredNo description.

affindamcp_get_integration_run#Get one integration run by ID — full, untruncated logs and output.1 param▾

Get one integration run by ID — full, untruncated logs and output.

NameTypeRequiredDescription

integration_run_idstringrequiredNo description.

affindamcp_get_usage#Get daily credits consumption for an organization over a date range.5 params▾

Get daily credits consumption for an organization over a date range.

NameTypeRequiredDescription

organization_idstringrequiredNo description.

document_type_idstringoptionalNo description.

end_datestringoptionalNo description.

start_datestringoptionalNo description.

workspace_idstringoptionalNo description.

affindamcp_get_validation_rule#Get one validation rule by ID — prompt, enabled, fields, missing-data option.1 param▾

Get one validation rule by ID — prompt, enabled, fields, missing-data option.

NameTypeRequiredDescription

validation_rule_idstringrequiredNo description.

affindamcp_get_workspace#Get one workspace by ID — name, organization, and document counts only.1 param▾

Get one workspace by ID — name, organization, and document counts only.

NameTypeRequiredDescription

workspace_idstringrequiredNo description.

affindamcp_get_workspace_details#Get a workspace's full configuration — settings + counts.1 param▾

Get a workspace's full configuration — settings + counts.

NameTypeRequiredDescription

workspace_idstringrequiredNo description.

affindamcp_list_data_source_values#List the rows (records) stored in a data source.2 params▾

List the rows (records) stored in a data source.

NameTypeRequiredDescription

data_source_idstringrequiredNo description.

limitintegeroptionalNo description.

affindamcp_list_data_sources#List data sources (lookup tables) defined on an organization.2 params▾

List data sources (lookup tables) defined on an organization.

NameTypeRequiredDescription

organization_idstringrequiredNo description.

limitintegeroptionalNo description.

affindamcp_list_document_splitters#List document splitters available to an organization.1 param▾

List document splitters available to an organization.

NameTypeRequiredDescription

organization_idstringrequiredNo description.

affindamcp_list_document_types#List document types in an organization.2 params▾

List document types in an organization.

NameTypeRequiredDescription

organization_idstringrequiredNo description.

limitintegeroptionalNo description.

affindamcp_list_documents#List documents in a workspace with their state and basic metadata.4 params▾

List documents in a workspace with their state and basic metadata.

NameTypeRequiredDescription

workspace_idstringrequiredNo description.

limitintegeroptionalNo description.

search_textstringoptionalNo description.

statestringoptionalNo description.

affindamcp_list_fields#List a document type's full field schema, grouped by field group.1 param▾

List a document type's full field schema, grouped by field group.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

affindamcp_list_integration_connections#List third-party service connections in an organization.1 param▾

List third-party service connections in an organization.

NameTypeRequiredDescription

organization_idstringrequiredNo description.

affindamcp_list_integration_runs#List recent runs for an integration, newest first.2 params▾

List recent runs for an integration, newest first.

NameTypeRequiredDescription

integration_idstringrequiredNo description.

limitintegeroptionalNo description.

affindamcp_list_integration_secrets#List the names of secrets configured for an integration.1 param▾

List the names of secrets configured for an integration.

NameTypeRequiredDescription

integration_idstringrequiredNo description.

affindamcp_list_integration_versions#List deployed-version snapshots for an integration, newest first.2 params▾

List deployed-version snapshots for an integration, newest first.

NameTypeRequiredDescription

integration_idstringrequiredNo description.

limitintegeroptionalNo description.

affindamcp_list_integrations#List integrations in an organization.4 params▾

List integrations in an organization.

NameTypeRequiredDescription

organization_idstringrequiredNo description.

enabledstringoptionalNo description.

limitintegeroptionalNo description.

workspace_idstringoptionalNo description.

affindamcp_list_matching_criteria#List matching criteria configured on a field.1 param▾

List matching criteria configured on a field.

NameTypeRequiredDescription

field_idstringrequiredNo description.

affindamcp_list_model_memory_documents#List the confirmed reference documents currently in a document type's model memory.2 params▾

List the confirmed reference documents currently in a document type's model memory.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

limitintegeroptionalNo description.

affindamcp_list_organizations#List organizations the current user belongs to.1 param▾

List organizations the current user belongs to.

NameTypeRequiredDescription

limitintegeroptionalNo description.

affindamcp_list_pipedream_apps#Search the catalogue of Pipedream apps available for new connections.1 param▾

Search the catalogue of Pipedream apps available for new connections.

NameTypeRequiredDescription

search_querystringoptionalNo description.

affindamcp_list_recent_field_annotations#Spot-check how one field is being extracted across recent documents.3 params▾

Spot-check how one field is being extracted across recent documents.

NameTypeRequiredDescription

field_idstringrequiredNo description.

filter_bystringoptionalNo description.

limitintegeroptionalNo description.

affindamcp_list_tags#List the tags defined in a workspace. Use this to discover the tag_id for downstream tools, to check whether a tag with a given name already exists before creating one, or to show the user what tags are available. Tags are workspace-scoped labels that can be applied to any number of documents. To apply or remove a tag on documents use add_tag_to_documents / remove_tag_from_documents. To see which tags a specific document carries, use get_document.2 params▾

List the tags defined in a workspace. Use this to discover the tag_id for downstream tools, to check whether a tag with a given name already exists before creating one, or to show the user what tags are available. Tags are workspace-scoped labels that can be applied to any number of documents. To apply or remove a tag on documents use add_tag_to_documents / remove_tag_from_documents. To see which tags a specific document carries, use get_document.

NameTypeRequiredDescription

workspace_idstringrequiredWorkspace to scope the list to. Required.

limitintegeroptionalCap on returned items. Default 100 — usually enough.

affindamcp_list_validation_rules#List validation rules attached to a document type.2 params▾

List validation rules attached to a document type.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

limitintegeroptionalNo description.

affindamcp_list_workspaces#List workspaces in an organization.2 params▾

List workspaces in an organization.

NameTypeRequiredDescription

organization_idstringrequiredNo description.

limitintegeroptionalNo description.

affindamcp_populate_document_type_fields#Auto-suggest fields for a document type by analysing sample documents.3 params▾

Auto-suggest fields for a document type by analysing sample documents.

NameTypeRequiredDescription

document_idsarrayrequiredNo description.

document_type_idstringrequiredNo description.

instructionsstringoptionalNo description.

affindamcp_reassign_document_type#Reassign documents to a different document type in the same workspace.3 params▾

Reassign documents to a different document type in the same workspace.

NameTypeRequiredDescription

document_idsarrayrequiredNo description.

document_type_idstringrequiredNo description.

reparsebooleanoptionalNo description.

affindamcp_reject_documents#Move documents to ``rejected`` state.1 param▾

Move documents to ``rejected`` state.

NameTypeRequiredDescription

document_idsarrayrequiredNo description.

affindamcp_remove_connection_from_integration#Detach a service connection from an integration.2 params▾

Detach a service connection from an integration.

NameTypeRequiredDescription

connection_idstringrequiredNo description.

integration_idstringrequiredNo description.

affindamcp_remove_tag_from_documents#Take a tag off one or more documents. Use this to un-label documents — e.g. "remove the Urgent tag from these invoices". The tag itself is kept and stays available for other documents; documents that don't carry the tag are unaffected. To delete the tag everywhere in one step, use delete_tag instead.2 params▾

Take a tag off one or more documents. Use this to un-label documents — e.g. "remove the Urgent tag from these invoices". The tag itself is kept and stays available for other documents; documents that don't carry the tag are unaffected. To delete the tag everywhere in one step, use delete_tag instead.

NameTypeRequiredDescription

document_idsarrayrequiredDocuments to remove the tag from.

tag_idstringrequiredID of the tag to remove.

affindamcp_revert_integration_version#Roll an integration back to a previous version and redeploy it.2 params▾

Roll an integration back to a previous version and redeploy it.

NameTypeRequiredDescription

integration_idstringrequiredNo description.

version_idstringrequiredNo description.

affindamcp_run_integration#Execute an integration against one document as a test run.2 params▾

Execute an integration against one document as a test run.

NameTypeRequiredDescription

document_idstringrequiredNo description.

integration_idstringrequiredNo description.

affindamcp_set_integration_secret#Create or update a secret on an integration. The value is stored only as an environment variable on the Lambda function — never in the database.3 params▾

Create or update a secret on an integration. The value is stored only as an environment variable on the Lambda function — never in the database.

NameTypeRequiredDescription

integration_idstringrequiredNo description.

namestringrequiredNo description.

valuestringrequiredNo description.

affindamcp_test_connection#Verify a service connection's credentials are still valid.1 param▾

Verify a service connection's credentials are still valid.

NameTypeRequiredDescription

connection_idstringrequiredNo description.

affindamcp_update_data_source#Update top-level settings on a data source (name, key, display property).4 params▾

Update top-level settings on a data source (name, key, display property).

NameTypeRequiredDescription

data_source_idstringrequiredNo description.

display_propertystringoptionalNo description.

key_propertystringoptionalNo description.

namestringoptionalNo description.

affindamcp_update_data_source_value#Update one row in a data source by its key — partial merge.3 params▾

Update one row in a data source by its key — partial merge.

NameTypeRequiredDescription

data_source_idstringrequiredNo description.

keystringrequiredNo description.

valuestringrequiredNo description.

affindamcp_update_document_type#Update one or more settings on an existing document type.5 params▾

Update one or more settings on an existing document type.

NameTypeRequiredDescription

document_type_idstringrequiredNo description.

auto_refresh_validation_resultsstringoptionalNo description.

disable_confirmation_if_validation_rules_failstringoptionalNo description.

namestringoptionalNo description.

show_redact_buttonstringoptionalNo description.

affindamcp_update_field#Update one or more settings on an existing field.21 params▾

Update one or more settings on an existing field.

NameTypeRequiredDescription

field_idstringrequiredNo description.

auto_confirm_if_validation_rules_passstringoptionalNo description.

decimal_placesstringoptionalNo description.

descriptionstringoptionalNo description.

display_enum_valuestringoptionalNo description.

display_raw_textstringoptionalNo description.

drop_nullstringoptionalNo description.

enabledstringoptionalNo description.

field_group_idstringoptionalNo description.

field_typestringoptionalNo description.

hide_enum_detailstringoptionalNo description.

labelstringoptionalNo description.

manual_entrystringoptionalNo description.

mapping_data_source_idstringoptionalNo description.

multiplestringoptionalNo description.

no_rectstringoptionalNo description.

optionsstringoptionalNo description.

positionstringoptionalNo description.

return_first_instance_onlystringoptionalNo description.

slugstringoptionalNo description.

transformation_promptstringoptionalNo description.

affindamcp_update_integration#Update one or more settings — including code — on an integration.8 params▾

Update one or more settings — including code — on an integration.

NameTypeRequiredDescription

integration_idstringrequiredNo description.

descriptionstringoptionalNo description.

document_type_idstringoptionalNo description.

enabledstringoptionalNo description.

eventstringoptionalNo description.

namestringoptionalNo description.

python_codestringoptionalNo description.

workspace_idstringoptionalNo description.

affindamcp_update_matching_criterion#Update settings on an existing matching criterion.7 params▾

Update settings on an existing matching criterion.

NameTypeRequiredDescription

matching_criterion_idstringrequiredNo description.

data_source_propertystringoptionalNo description.

field_attributestringoptionalNo description.

match_typestringoptionalNo description.

requiredstringoptionalNo description.

required_strictstringoptionalNo description.

source_field_idstringoptionalNo description.

affindamcp_update_organization#Rename an organization.2 params▾

Rename an organization.

NameTypeRequiredDescription

namestringrequiredNo description.

organization_idstringrequiredNo description.

affindamcp_update_tag#Rename a tag. Use this when the user wants to change a tag's name — e.g. "rename the Urgent tag to High Priority". The rename applies everywhere at once: every document carrying the tag shows the new name immediately. A tag cannot be moved to a different workspace; create a new tag there instead. To change which documents carry the tag, use add_tag_to_documents / remove_tag_from_documents.2 params▾

Rename a tag. Use this when the user wants to change a tag's name — e.g. "rename the Urgent tag to High Priority". The rename applies everywhere at once: every document carrying the tag shows the new name immediately. A tag cannot be moved to a different workspace; create a new tag there instead. To change which documents carry the tag, use add_tag_to_documents / remove_tag_from_documents.

NameTypeRequiredDescription

namestringrequiredNew tag name. Max 256 chars.

tag_idstringrequiredID of the tag to rename.

affindamcp_update_validation_rule#Update one or more settings on an existing validation rule.6 params▾

Update one or more settings on an existing validation rule.

NameTypeRequiredDescription

validation_rule_idstringrequiredNo description.

enabledstringoptionalNo description.

field_idsstringoptionalNo description.

generate_codebooleanoptionalNo description.

missing_data_optionstringoptionalNo description.

promptstringoptionalNo description.

affindamcp_update_workspace#Update one or more settings on an existing workspace.11 params▾

Update one or more settings on an existing workspace.

NameTypeRequiredDescription

workspace_idstringrequiredNo description.

auto_validationstringoptionalNo description.

document_splitter_idstringoptionalNo description.

enable_document_classificationstringoptionalNo description.

enable_document_splittingstringoptionalNo description.

enable_validationstringoptionalNo description.

model_memory_strategystringoptionalNo description.

namestringoptionalNo description.

ocr_modestringoptionalNo description.

reject_duplicatesstringoptionalNo description.

visibilitystringoptionalNo description.

affindamcp_wait_for_document_processing#Block until every document in a workspace has finished processing.2 params▾

Block until every document in a workspace has finished processing.

NameTypeRequiredDescription

workspace_idstringrequiredNo description.

timeout_secondsintegeroptionalNo description.