Back to MCP Overview

Linked Records Tools

Tools for creating links between records in different tables.

6 tools

Available Tools

linkedRecords_createLinkField

Create a link field to connect two tables

Input Schema

tableIdstringrequired

Source table ID from listTables

namestringrequired

Name for the link field

descriptionstring

Optional description

linkedTableIdstringrequired

Target table ID to link to

linkTypestringrequired

Relationship type: "one_to_one", "one_to_many", or "many_to_many"

linkDisplayModestring

Display mode: "COUNT", "LABELS", or "CHIPS"

allowMultipleLinksboolean

Allow linking to multiple records

linkOnDeletestring

Action on delete: "CASCADE", "SET_NULL", "RESTRICT", "NO_ACTION"

linkOnUpdatestring

Action on update

createReciprocalboolean

Create reciprocal field in target table

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedRecords_createLinkField",
    "arguments": {
          "tableId": "example",
          "name": "example",
          "description": "example"
    }
  }
}
linkedRecords_linkRecords

Link records between tables

Input Schema

tableIdstringrequired

Source table ID

recordIdstringrequired

Source row ID to link from

fieldIdstringrequired

Link field ID

linkedRecordIdsarrayrequired

Array of target row IDs to link to

preserveOrderboolean

Preserve order of linked records

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedRecords_linkRecords",
    "arguments": {
          "tableId": "example",
          "recordId": "example",
          "fieldId": "example"
    }
  }
}
linkedRecords_unlinkRecords

Unlink records between tables

Input Schema

tableIdstringrequired

Source table ID

recordIdstringrequired

Source row ID

fieldIdstringrequired

Link field ID

linkedRecordIdsarrayrequired

Array of target row IDs to unlink

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedRecords_unlinkRecords",
    "arguments": {
          "tableId": "example",
          "recordId": "example",
          "fieldId": "example"
    }
  }
}
linkedRecords_getLinkedRecords

Get linked records for a record

Input Schema

tableIdstringrequired

Source table ID

recordIdstringrequired

Source row ID

fieldIdstringrequired

Link field ID

expandboolean

Include full record data

limitnumber

Max records to return (default: 50)

offsetnumber

Skip records for pagination

sortBystring

Field to sort by

sortDirectionstring

Sort direction

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedRecords_getLinkedRecords",
    "arguments": {
          "tableId": "example",
          "recordId": "example",
          "fieldId": "example"
    }
  }
}
linkedRecords_bulkLinkRecords

Bulk link/unlink operations on multiple records

Input Schema

tableIdstringrequired

Source table ID

fieldIdstringrequired

Link field ID

operationsarrayrequired

Array of link operations to perform

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedRecords_bulkLinkRecords",
    "arguments": {
          "tableId": "example",
          "fieldId": "example",
          "operations": {}
    }
  }
}
linkedRecords_reorderLinkedRecords

Reorder linked records

Input Schema

tableIdstringrequired

Source table ID

recordIdstringrequired

Source row ID

fieldIdstringrequired

Link field ID

orderedRecordIdsarrayrequired

Target row IDs in desired order

Example Call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "linkedRecords_reorderLinkedRecords",
    "arguments": {
          "tableId": "example",
          "recordId": "example",
          "fieldId": "example"
    }
  }
}
Linked Records MCP Tools - Serenities