fix(plugin-mcp): create and update resource tools now support point fields (#15381)

Fixes: #15287
The Create and Update Resource tools were expecting a tuple for point
fields, however they needed to also accept nest lat/lng objects.
Tools affected:
- createResource
- updateResource

Author: kendelljoseph

packages/plugin-mcp/src/mcp/tools/resource/create.ts

@@ -8,6 +8,7 @@ import type { PluginMCPServerConfig } from '../../../types.js'
 
 import{toCamelCase}from'../../../utils/camelCase.js'
 import{convertCollectionSchemaToZod}from'../../../utils/convertCollectionSchemaToZod.js'
+import{transformPointDataToPayload}from'../../../utils/transformPointDataToPayload.js'
 import{toolSchemas}from'../schemas.js'
 exportconstcreateResourceTool=(
 server: McpServer,
@@ -44,6 +45,10 @@ export const createResourceTool = (
 letparsedData: Record<string,unknown>
 try{
 parsedData=JSON.parse(data)
+
+// Transform point fields from object format to tuple array
+parsedData=transformPointDataToPayload(parsedData)
+
 if(verboseLogs){
 payload.logger.info(
 `[payload-mcp] Parsed data for ${collectionSlug}: ${JSON.stringify(parsedData)}`,

packages/plugin-mcp/src/mcp/tools/resource/update.ts

@@ -8,6 +8,7 @@ import type { PluginMCPServerConfig } from '../../../types.js'
 
 import{toCamelCase}from'../../../utils/camelCase.js'
 import{convertCollectionSchemaToZod}from'../../../utils/convertCollectionSchemaToZod.js'
+import{transformPointDataToPayload}from'../../../utils/transformPointDataToPayload.js'
 import{toolSchemas}from'../schemas.js'
 exportconstupdateResourceTool=(
 server: McpServer,
@@ -49,6 +50,10 @@ export const updateResourceTool = (
 letparsedData: Record<string,unknown>
 try{
 parsedData=JSON.parse(data)
+
+// Transform point fields from object format to tuple array
+parsedData=transformPointDataToPayload(parsedData)
+
 if(verboseLogs){
 payload.logger.info(
 `[payload-mcp] Parsed data for ${collectionSlug}: ${JSON.stringify(parsedData)}`,

packages/plugin-mcp/src/utils/convertCollectionSchemaToZod.ts

@@ -4,6 +4,8 @@ import { jsonSchemaToZod } from 'json-schema-to-zod'
 import*astsfrom'typescript'
 import{z}from'zod'
 
+import{transformPointFieldsForMCP}from'./transformPointFields.js'
+
 /**
  * Recursively processes JSON schema properties to simplify relationship fields.
  * For create/update validation we only need to accept IDs (string/number),
@@ -65,7 +67,8 @@ export const convertCollectionSchemaToZod = (schema: JSONSchema4) => {
 }
 }
 
-constsimplifiedSchema=simplifyRelationshipFields(schemaClone)
+constpointTransformed=transformPointFieldsForMCP(schemaClone)
+constsimplifiedSchema=simplifyRelationshipFields(pointTransformed)
 
 constzodSchemaAsString=jsonSchemaToZod(simplifiedSchema)
 

packages/plugin-mcp/src/utils/transformPointDataToPayload.ts

@@ -0,0 +1,40 @@
+/**
+ * Transforms incoming MCP tool data from object format to tuple array format.
+ * Converts { longitude: number, latitude: number } back to [longitude, latitude]
+ * for Payload's internal point field representation.
+ */
+exportfunctiontransformPointDataToPayload(
+data: Record<string,unknown>,
+): Record<string,unknown>{
+if(!data||typeofdata!=='object'){
+returndata
+}
+
+consttransformed: Record<string,unknown>={}
+
+for(const[key,value]ofObject.entries(data)){
+if(
+value&&
+typeofvalue==='object'&&
+'longitude'invalue&&
+'latitude'invalue&&
+typeofvalue.longitude==='number'&&
+typeofvalue.latitude==='number'
+){
+// Transform to tuple array [longitude, latitude]
+transformed[key]=[value.longitude,value.latitude]
+}elseif(Array.isArray(value)){
+transformed[key]=value.map((item)=>
+typeofitem==='object'
+ ? transformPointDataToPayload(itemasRecord<string,unknown>)
+ : item,
+)
+}elseif(value&&typeofvalue==='object'){
+transformed[key]=transformPointDataToPayload(valueasRecord<string,unknown>)
+}else{
+transformed[key]=value
+}
+}
+
+returntransformed
+}

packages/plugin-mcp/src/utils/transformPointFields.ts

@@ -0,0 +1,55 @@
+importtype{JSONSchema4}from'json-schema'
+
+exportfunctiontransformPointFieldsForMCP(schema: JSONSchema4): JSONSchema4{
+if(!schema||typeofschema!=='object'){
+returnschema
+}
+
+consttransformed={ ...schema}
+
+if(transformed.properties&&typeoftransformed.properties==='object'){
+transformed.properties=Object.fromEntries(
+Object.entries(transformed.properties).map(([key,value])=>{
+constisArrayType=
+value.type==='array'||(Array.isArray(value.type)&&value.type.includes('array'))
+
+if(
+value&&
+typeofvalue==='object'&&
+isArrayType&&
+Array.isArray(value.items)&&
+value.items.length===2&&
+value.items.every((item: JSONSchema4)=>item?.type==='number')
+){
+// Transform to object format
+constisNullable=Array.isArray(value.type)&&value.type.includes('null')
+
+return[
+key,
+{
+type: isNullable ? ['object','null'] : 'object',
+description: value.description||'Geographic coordinates (longitude, latitude)',
+properties: {
+latitude: {type: 'number',description: 'Latitude coordinate'},
+longitude: {type: 'number',description: 'Longitude coordinate'},
+},
+required: ['longitude','latitude'],
+},
+]
+}
+
+return[key,transformPointFieldsForMCP(value)]
+}),
+)
+}
+
+if(
+transformed.items&&
+typeoftransformed.items==='object'&&
+!Array.isArray(transformed.items)
+){
+transformed.items=transformPointFieldsForMCP(transformed.items)
+}
+
+returntransformed
+}

test/plugin-mcp/collections/Posts.ts

@@ -2,35 +2,39 @@ import type { CollectionConfig } from 'payload'
 
 exportconstPosts: CollectionConfig={
 slug: 'posts',
-versions: {
-drafts: true,
-},
 fields: [
 {
 name: 'title',
 type: 'text',
-localized: true,
 admin: {
 description: 'The title of the post',
 },
+localized: true,
 required: true,
 },
 {
 name: 'content',
 type: 'text',
-localized: true,
 admin: {
 description: 'The content of the post',
 },
 defaultValue: 'Hello World.',
+localized: true,
 },
 {
 name: 'author',
 type: 'relationship',
-relationTo: 'users',
 admin: {
 description: 'The author of the post',
 },
+relationTo: 'users',
+},
+{
+name: 'location',
+type: 'point',
+admin: {
+description: 'Geographic location coordinates',
+},
 },
 ],
 hooks: {
@@ -52,4 +56,7 @@ export const Posts: CollectionConfig = {
 },
 ],
 },
+versions: {
+drafts: true,
+},
 }