adoptai-mcp 1.0.0

package/dist/integrations/salesforce/publish-smart-specs.js

@@ -0,0 +1,890 @@
+/**
+ * HTTP mappings for Salesforce MCP “smart” tools that are not Postman-generated.
+ * Used only by publish-to-adoptai.js (adopt catalog), not at MCP runtime.
+ */
+
+export const SMART_PUBLISH_SPECS = {
+  get_account: {
+    method: 'GET',
+    path: '/sobjects/Account/{account_id}',
+    urlKind: 'versioned',
+    queryParamsExplicit: { fields: '{fields}' },
+  },
+
+  get_account_with_contacts: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema(
+      'SOQL for account + contacts. Example: SELECT Id,Name,(SELECT Id,FirstName,LastName,Email FROM Contacts) FROM Account WHERE Id = \'001…\''
+    ),
+    note: 'MCP builds SOQL from account_id; via HTTP pass the full SOQL as q.',
+  },
+  get_account_with_opportunities: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema(
+      'SOQL for account + opportunities. Example: SELECT Id,Name,(SELECT Id,Name,StageName,Amount FROM Opportunities) FROM Account WHERE Id = \'001…\''
+    ),
+    note: 'MCP builds SOQL from account_id; via HTTP pass the full SOQL as q.',
+  },
+  get_account_with_cases: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema(
+      'SOQL for account + open cases. Example: SELECT Id,Name,(SELECT Id,CaseNumber,Subject,Status FROM Cases WHERE IsClosed=false) FROM Account WHERE Id = \'001…\''
+    ),
+    note: 'MCP builds SOQL from account_id; via HTTP pass the full SOQL as q.',
+  },
+  get_account_full_profile: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema(
+      'SOQL for account + contacts + opportunities + cases in one query.'
+    ),
+    note: 'MCP builds SOQL from account_id; via HTTP pass the full SOQL as q.',
+  },
+
+  update_opportunity: {
+    method: 'PATCH',
+    path: '/sobjects/Opportunity/{opportunity_id}',
+    urlKind: 'versioned',
+  },
+  update_opportunity_stage: {
+    method: 'PATCH',
+    path: '/sobjects/Opportunity/{opportunity_id}',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      StageName: '{stage}',
+      CloseDate: '{close_date}',
+      Probability: '{probability}',
+    },
+    omitArgsFromHttp: [],
+  },
+  update_opportunity_amount: {
+    method: 'PATCH',
+    path: '/sobjects/Opportunity/{opportunity_id}',
+    urlKind: 'versioned',
+    bodyExplicit: { Amount: '{amount}' },
+  },
+  update_opportunity_close_date: {
+    method: 'PATCH',
+    path: '/sobjects/Opportunity/{opportunity_id}',
+    urlKind: 'versioned',
+    bodyExplicit: { CloseDate: '{close_date}' },
+  },
+  close_won_opportunity: {
+    method: 'PATCH',
+    path: '/sobjects/Opportunity/{opportunity_id}',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      StageName: 'Closed Won',
+      Probability: 100,
+      CloseDate: '{close_date}',
+    },
+  },
+  close_lost_opportunity: {
+    method: 'PATCH',
+    path: '/sobjects/Opportunity/{opportunity_id}',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      StageName: 'Closed Lost',
+      Probability: 0,
+      Description: '{loss_reason}',
+    },
+  },
+
+  run_soql_query: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{query}' },
+    omitArgsFromHttp: ['limit'],
+    note: 'limit is MCP-only (appends LIMIT to SOQL). For HTTP, include LIMIT inside query or omit.',
+  },
+  run_soql_query_all_pages: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{query}' },
+    omitArgsFromHttp: ['max_records'],
+    note: 'Returns first page only via HTTP; use nextRecordsUrl for more pages. max_records is MCP-only.',
+  },
+
+  search_accounts: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema('SOQL for Account search (MCP builds from name/industry/type/city).'),
+    note: 'MCP composes WHERE from filters; via HTTP pass full SOQL as q.',
+  },
+  search_contacts: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema('SOQL for Contact search.'),
+    note: 'MCP composes WHERE from filters; via HTTP pass full SOQL as q.',
+  },
+  search_leads: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema('SOQL for Lead search.'),
+    note: 'MCP composes WHERE from filters; via HTTP pass full SOQL as q.',
+  },
+  search_opportunities: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema('SOQL for Opportunity search.'),
+    note: 'MCP composes WHERE from filters; via HTTP pass full SOQL as q.',
+  },
+  get_pipeline_summary: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema(
+      'Aggregate SOQL e.g. SELECT StageName, COUNT(Id), SUM(Amount) FROM Opportunity WHERE IsClosed = false … GROUP BY StageName'
+    ),
+    note: 'MCP builds GROUP BY from owner_id/period; via HTTP pass full SOQL as q.',
+  },
+  global_search: {
+    method: 'GET',
+    path: '/search/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        q: {
+          type: 'string',
+          description:
+            'Full SOSL string, e.g. FIND {Acme} IN ALL FIELDS RETURNING Account(Id,Name),Contact(Id,Name) LIMIT 10',
+        },
+      },
+      required: ['q'],
+    },
+    note: 'MCP builds SOSL from search_term/objects/limit; via HTTP pass full SOSL as q.',
+  },
+
+  create_task: {
+    method: 'POST',
+    path: '/sobjects/Task',
+    urlKind: 'versioned',
+  },
+  log_call: {
+    method: 'POST',
+    path: '/sobjects/Task',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      Subject: '{subject}',
+      Type: 'Call',
+      Status: 'Completed',
+      TaskSubtype: 'Call',
+      WhoId: '{who_id}',
+      WhatId: '{what_id}',
+      Description: '{description}',
+      CallDurationInSeconds: '{duration_seconds}',
+      CallDisposition: '{call_disposition}',
+      CallType: '{call_type}',
+    },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        subject: { type: 'string' },
+        who_id: { type: 'string' },
+        what_id: { type: 'string' },
+        description: { type: 'string' },
+        duration_seconds: {
+          type: 'number',
+          description: 'Call duration in seconds (MCP uses duration_minutes × 60).',
+        },
+        call_disposition: { type: 'string' },
+        call_type: { type: 'string' },
+      },
+      required: ['subject'],
+    },
+    note: 'MCP maps duration_minutes to CallDurationInSeconds; HTTP uses duration_seconds.',
+  },
+  log_email: {
+    method: 'POST',
+    path: '/sobjects/EmailMessage',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      Subject: '{subject}',
+      Status: '3',
+      Incoming: false,
+      TextBody: '{body}',
+      ToAddress: '{to_address}',
+      MessageDate: '{sent_date}',
+      RelatedToId: '{related_to_id}',
+    },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        subject: { type: 'string' },
+        to_address: { type: 'string' },
+        body: { type: 'string' },
+        sent_date: { type: 'string' },
+        related_to_id: {
+          type: 'string',
+          description: 'MCP sets from what_id or who_id; pass the target record Id.',
+        },
+      },
+      required: ['subject'],
+    },
+    note: 'Set related_to_id to WhatId/WhoId target. MCP chooses what_id vs who_id.',
+  },
+  create_followup_task: {
+    method: 'POST',
+    path: '/sobjects/Task',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      Subject: '{subject}',
+      ActivityDate: '{due_date}',
+      Status: 'Not Started',
+      WhoId: '{who_id}',
+      WhatId: '{what_id}',
+      Priority: '{priority}',
+      OwnerId: '{assigned_to_id}',
+      Description: '{description}',
+    },
+  },
+  get_todays_tasks: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema(
+      'SOQL for open tasks (today / overdue). Include OwnerId filter and ActivityDate predicates.'
+    ),
+    note: 'MCP defaults OwnerId from OAuth user; via HTTP include OwnerId in SOQL.',
+  },
+  get_overdue_tasks: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema('SOQL for overdue tasks for a user.'),
+    note: 'MCP defaults OwnerId from OAuth; via HTTP include OwnerId in SOQL.',
+  },
+
+  update_lead: {
+    method: 'PATCH',
+    path: '/sobjects/Lead/{lead_id}',
+    urlKind: 'versioned',
+  },
+  update_lead_status: {
+    method: 'PATCH',
+    path: '/sobjects/Lead/{lead_id}',
+    urlKind: 'versioned',
+    bodyExplicit: { Status: '{status}' },
+  },
+  convert_lead: {
+    method: 'POST',
+    path: '/sobjects/Lead/{lead_id}/actions/standard/convert',
+    urlKind: 'versioned',
+    bodyExplicit: { inputs: '{inputs}' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        lead_id: { type: 'string' },
+        inputs: {
+          type: 'array',
+          items: { type: 'object', additionalProperties: true },
+          description: 'Salesforce Lead convert inputs[] (leadId, convertedStatus, doNotCreateOpportunity, etc.).',
+        },
+      },
+      required: ['lead_id', 'inputs'],
+    },
+    note: 'MCP builds inputs from create_opportunity/opportunity_name/account_id/contact_id; HTTP must pass inputs array.',
+  },
+
+  bulk_create_records: {
+    method: 'POST',
+    path: '/jobs/ingest',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      object: '{object_type}',
+      operation: 'insert',
+      contentType: 'CSV',
+      lineEnding: 'LF',
+      columnDelimiter: 'COMMA',
+    },
+    omitArgsFromHttp: ['records', 'batch_size'],
+    note: 'Creates Bulk API 2 ingest job only. Upload CSV with bulk_v2_upload_job_data, then PATCH job UploadComplete.',
+  },
+  bulk_update_records: {
+    method: 'POST',
+    path: '/jobs/ingest',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      object: '{object_type}',
+      operation: 'update',
+      contentType: 'CSV',
+      lineEnding: 'LF',
+      columnDelimiter: 'COMMA',
+    },
+    omitArgsFromHttp: ['records', 'batch_size'],
+    note: 'Creates job only; upload rows with Id column via bulk_v2_upload_job_data.',
+  },
+  bulk_upsert_records: {
+    method: 'POST',
+    path: '/jobs/ingest',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      object: '{object_type}',
+      operation: 'upsert',
+      externalIdFieldName: '{external_id_field}',
+      contentType: 'CSV',
+      lineEnding: 'LF',
+      columnDelimiter: 'COMMA',
+    },
+    omitArgsFromHttp: ['records', 'batch_size'],
+    note: 'Creates job only; upload CSV via bulk_v2_upload_job_data.',
+  },
+  bulk_delete_records: {
+    method: 'POST',
+    path: '/jobs/ingest',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      object: '{object_type}',
+      operation: 'delete',
+      contentType: 'CSV',
+      lineEnding: 'LF',
+      columnDelimiter: 'COMMA',
+    },
+    omitArgsFromHttp: ['record_ids'],
+    note: 'Creates delete job; MCP sends Ids as CSV. Via HTTP create job then PUT CSV of Ids to batches.',
+  },
+  get_bulk_job_status: {
+    method: 'GET',
+    path: '/jobs/ingest/{job_id}',
+    urlKind: 'versioned',
+  },
+  get_bulk_job_results: {
+    method: 'GET',
+    path: '/jobs/ingest/{job_id}/{result_segment}',
+    urlKind: 'versioned',
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        job_id: { type: 'string' },
+        result_segment: {
+          type: 'string',
+          enum: ['successfulResults', 'failedResults', 'unprocessedrecords'],
+          description: 'Path segment (note lowercase c in unprocessedrecords per Salesforce).',
+        },
+      },
+      required: ['job_id', 'result_segment'],
+    },
+    extraHeaders: { accept: 'text/csv' },
+    note: 'Returns CSV. Enum matches URL path segment.',
+  },
+  bulk_v2_upload_job_data: {
+    method: 'PUT',
+    path: '/jobs/ingest/{job_id}/batches',
+    urlKind: 'versioned',
+    rawStringBodyArg: 'csv_data',
+    contentTypeOverride: 'text/csv',
+    extraHeaders: { accept: 'application/json' },
+    note: 'Request body must be raw CSV bytes (not JSON). Adopt must substitute csv_data as raw body.',
+  },
+
+  bulk_v1_bulk_retrieve_batch_re_b03d6: {
+    method: 'GET',
+    path: '/job/{jobId}/batch/{batchId}/result/{batchResultId}',
+    urlKind: 'bulk-v1-async',
+    extraHeaders: { accept: 'text/csv' },
+  },
+  bulk_v1_bulk_retrieve_batch_result: {
+    method: 'GET',
+    path: '/job/{jobId}/batch/{batchId}/result',
+    urlKind: 'bulk-v1-async',
+    extraHeaders: { accept: 'text/csv' },
+  },
+  bulk_v1_get_job_query_result: {
+    method: 'GET',
+    path: '/jobs/query/{jobId}/results',
+    urlKind: 'versioned',
+    extraHeaders: { accept: 'text/csv' },
+  },
+  bulk_v1_bulk_create_batch: {
+    method: 'POST',
+    path: '/job/{jobId}/batch',
+    urlKind: 'bulk-v1-async',
+    rawStringBodyArg: 'csv_data',
+    contentTypeOverride: 'text/csv',
+    extraHeaders: { accept: 'application/json' },
+    note: 'Raw CSV body.',
+  },
+  bulk_v1_bulk_spec: {
+    method: 'POST',
+    path: '/job/{jobId}/spec',
+    urlKind: 'bulk-v1-async',
+    rawStringBodyArg: 'csv_data',
+    contentTypeOverride: 'text/csv',
+    extraHeaders: { accept: 'application/json' },
+    note: 'Raw CSV body for bulk spec.',
+  },
+
+  composite_create_acct_with_contact: {
+    method: 'POST',
+    path: '/composite/',
+    urlKind: 'versioned',
+    bodyExplicit: { compositeRequest: '{compositeRequest}' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        compositeRequest: {
+          type: 'array',
+          items: { type: 'object', additionalProperties: true },
+          description: 'Composite subrequests (e.g. POST Account then POST Contact with AccountId @{refAccount.id}).',
+        },
+      },
+      required: ['compositeRequest'],
+    },
+    note: 'MCP builds compositeRequest from account/contact objects.',
+  },
+  comp_opp_with_contact_role: {
+    method: 'POST',
+    path: '/composite/',
+    urlKind: 'versioned',
+    bodyExplicit: { compositeRequest: '{compositeRequest}' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        compositeRequest: { type: 'array', items: { type: 'object', additionalProperties: true } },
+      },
+      required: ['compositeRequest'],
+    },
+    note: 'MCP builds Opportunity + OpportunityContactRole requests.',
+  },
+  batch_get_records: {
+    method: 'POST',
+    path: '/composite/batch',
+    urlKind: 'versioned',
+    bodyExplicit: { batchRequests: '{batchRequests}', haltOnError: '{halt_on_error}' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        batchRequests: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              method: { type: 'string' },
+              url: { type: 'string' },
+            },
+            required: ['url'],
+          },
+        },
+        haltOnError: { type: 'boolean' },
+      },
+      required: ['batchRequests'],
+    },
+  },
+  mass_transfer_ownership: {
+    method: 'PATCH',
+    path: '/composite/sobjects',
+    urlKind: 'versioned',
+    bodyExplicit: { allOrNone: '{all_or_none}', records: '{records}' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        all_or_none: { type: 'boolean' },
+        records: {
+          type: 'array',
+          items: { type: 'object', additionalProperties: true },
+          description: 'Each { attributes: { type }, id, OwnerId }',
+        },
+      },
+      required: ['records'],
+    },
+    note: 'MCP builds records from object_type, record_ids, new_owner_id.',
+  },
+
+  get_picklist_values: {
+    method: 'GET',
+    path: '/sobjects/{object_type}/describe',
+    urlKind: 'versioned',
+    note: 'Returns full describe; MCP extracts one field’s picklist client-side.',
+  },
+  get_record_types: {
+    method: 'GET',
+    path: '/sobjects/{object_type}/describe',
+    urlKind: 'versioned',
+    note: 'Use describe.recordTypeInfos; MCP summarizes.',
+  },
+
+  metadata_soap_describemetadata: {
+    method: 'POST',
+    path: '',
+    urlKind: 'soap-metadata',
+    rawStringBodyArg: 'soap_xml',
+    contentTypeOverride: 'text/xml; charset=UTF-8',
+    extraHeaders: { accept: 'text/xml', soapaction: '""' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        soap_xml: {
+          type: 'string',
+          description: 'Full SOAP XML envelope (SessionHeader with sessionId; describeMetadata body).',
+        },
+      },
+      required: ['soap_xml'],
+    },
+    note: 'MCP builds XML from as_of_version. Token must be embedded in soap_xml or use bearer per org setup.',
+  },
+  metadata_soap_describevaluetype: {
+    method: 'POST',
+    path: '',
+    urlKind: 'soap-metadata',
+    rawStringBodyArg: 'soap_xml',
+    contentTypeOverride: 'text/xml; charset=UTF-8',
+    extraHeaders: { accept: 'text/xml', soapaction: '""' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: { soap_xml: { type: 'string' } },
+      required: ['soap_xml'],
+    },
+    note: 'MCP substitutes metadata_type into template.',
+  },
+  metadata_soap_list_metadata: {
+    method: 'POST',
+    path: '',
+    urlKind: 'soap-metadata',
+    rawStringBodyArg: 'soap_xml',
+    contentTypeOverride: 'text/xml; charset=UTF-8',
+    extraHeaders: { accept: 'text/xml', soapaction: '""' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: { soap_xml: { type: 'string' } },
+      required: ['soap_xml'],
+    },
+    note: 'MCP builds listMetadata envelope from metadata_type, folder, as_of_version.',
+  },
+
+  post_chatter_message: {
+    method: 'POST',
+    path: '/chatter/feed-elements',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      feedElementType: '{feedElementType}',
+      subjectId: '{subjectId}',
+      body: '{body}',
+    },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        feedElementType: { type: 'string', description: 'Usually FeedItem' },
+        subjectId: { type: 'string' },
+        body: {
+          type: 'object',
+          additionalProperties: true,
+          description: '{ messageSegments: [{ type, text } | { type: Mention, id }] }',
+        },
+      },
+      required: ['subjectId', 'body'],
+    },
+    note: 'MCP maps message_text + mentions into body.messageSegments.',
+  },
+  get_record_feed: {
+    method: 'GET',
+    path: '/chatter/feeds/record/{RECORD_GROUP_ID}/feed-elements',
+    urlKind: 'versioned',
+    pathPlaceholderArgs: { RECORD_GROUP_ID: 'record_id' },
+    queryParamsExplicit: { pageSize: '{page_size}' },
+  },
+  upload_file_to_record: {
+    method: 'POST',
+    path: '/sobjects/ContentVersion',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      Title: '{file_name}',
+      PathOnClient: '{file_name}',
+      VersionData: '{file_content_base64}',
+      FirstPublishLocationId: '{record_id}',
+    },
+    note: 'ContentVersion REST (base64). MCP uses multipart upload + feed-element link.',
+  },
+  get_user_profile: {
+    method: 'GET',
+    path: '/chatter/users/{user_id}',
+    urlKind: 'versioned',
+    note: 'Use user_id me for the connected user.',
+  },
+  list_groups: {
+    method: 'GET',
+    path: '/chatter/groups',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{query}', pageSize: '{limit}' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        query: { type: 'string' },
+        limit: { type: 'number', description: 'Maps to pageSize' },
+      },
+      required: [],
+    },
+  },
+
+  execute_apex: {
+    method: 'GET',
+    path: '/executeAnonymous',
+    urlKind: 'tooling',
+    queryParamsExplicit: { anonymousBody: '{apex_body}' },
+  },
+  get_apex_logs: {
+    method: 'GET',
+    path: '/query',
+    urlKind: 'tooling',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema('Tooling SOQL for ApexLog (MCP builds WHERE/LIMIT).'),
+    note: 'Pass full Tooling API SOQL as q.',
+  },
+  run_apex_tests: {
+    method: 'POST',
+    path: '/runTestsAsynchronous',
+    urlKind: 'tooling',
+    bodyExplicit: { classNames: '{class_names}' },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        class_names: {
+          type: 'string',
+          description: 'Comma-separated Apex test class API names (MCP used array).',
+        },
+      },
+      required: ['class_names'],
+    },
+  },
+  query_tooling_api: {
+    method: 'GET',
+    path: '/query',
+    urlKind: 'tooling',
+    queryParamsExplicit: { q: '{query}' },
+  },
+  list_apex_classes: {
+    method: 'GET',
+    path: '/query',
+    urlKind: 'tooling',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema('Tooling SOQL for ApexClass (MCP builds name_filter/LIMIT).'),
+    note: 'Pass full Tooling SOQL as q.',
+  },
+
+  get_record_ui: {
+    method: 'GET',
+    path: '/record-ui/{RECORD_IDS}',
+    urlKind: 'ui-api',
+    pathPlaceholderArgs: { RECORD_IDS: 'record_id' },
+    queryParamsExplicit: { layoutTypes: '{layout_types}', modes: '{modes}' },
+    note: 'layout_types and modes: comma-separated strings (or JSON string).',
+  },
+  get_object_info: {
+    method: 'GET',
+    path: '/object-info/{SOBJECT_API_NAME}',
+    urlKind: 'ui-api',
+    pathPlaceholderArgs: { SOBJECT_API_NAME: 'object_api_name' },
+  },
+  get_picklist_values_ui: {
+    method: 'GET',
+    path: '/object-info/{SOBJECT_API_NAME}/picklist-values/{RECORD_TYPE_ID}',
+    urlKind: 'ui-api',
+    pathPlaceholderArgs: {
+      SOBJECT_API_NAME: 'object_api_name',
+      RECORD_TYPE_ID: 'record_type_id',
+    },
+    note: 'MCP may fetch default record type first; HTTP must pass record_type_id.',
+  },
+  get_layout: {
+    method: 'GET',
+    path: '/layout/{SOBJECT_API_NAME}',
+    urlKind: 'ui-api',
+    pathPlaceholderArgs: { SOBJECT_API_NAME: 'object_api_name' },
+    queryParamsExplicit: {
+      layoutTypes: '{layout_type}',
+      recordTypeId: '{record_type_id}',
+      modes: 'View',
+    },
+  },
+
+  analyze_sentiment: {
+    method: 'POST',
+    path: '/language/sentiment',
+    urlKind: 'einstein-platform',
+    bodyExplicit: { modelId: '{model_id}', document: '{text}' },
+    note: 'Einstein Language: real API is often multipart/form-data; JSON may not work—prefer MCP if calls fail.',
+  },
+  classify_intent: {
+    method: 'POST',
+    path: '/language/intent',
+    urlKind: 'einstein-platform',
+    bodyExplicit: { modelId: '{model_id}', document: '{text}' },
+    note: 'Often multipart; JSON fallback.',
+  },
+  predict_image: {
+    method: 'POST',
+    path: '/vision/predict',
+    urlKind: 'einstein-platform',
+    bodyExplicit: {
+      modelId: '{model_id}',
+      sampleLocation: '{image_url}',
+      sampleBase64Content: '{image_base64}',
+    },
+    note: 'Provide image_url XOR image_base64. Often multipart; JSON fallback.',
+  },
+
+  publish_platform_event: {
+    method: 'POST',
+    path: '/sobjects/{event_api_name}',
+    urlKind: 'versioned',
+    wholeBodyPlaceholderArg: 'event_data',
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        event_api_name: {
+          type: 'string',
+          description: 'Platform event API name including __e suffix.',
+        },
+        event_data: { type: 'object', additionalProperties: true },
+      },
+      required: ['event_api_name'],
+    },
+    note: 'JSON body is the event fields. MCP wraps event_name → apiName.',
+  },
+  list_platform_events: {
+    method: 'GET',
+    path: '/query',
+    urlKind: 'tooling',
+    queryParamsLiteral: {
+      q: "SELECT QualifiedApiName, Label, DeveloperName, DurableId FROM EntityDefinition WHERE QualifiedApiName LIKE '%__e' ORDER BY QualifiedApiName LIMIT 500",
+    },
+    inputSchemaOverride: { type: 'object', properties: {}, required: [] },
+  },
+  create_streaming_topic: {
+    method: 'POST',
+    path: '/sobjects/PushTopic',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      Name: '{name}',
+      Query: '{query}',
+      NotifyForFields: '{notify_for_fields}',
+      ApiVersion: '{api_version}',
+    },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        name: { type: 'string' },
+        query: { type: 'string' },
+        notify_for_fields: { type: 'string' },
+        api_version: { type: 'string', description: 'Numeric API version e.g. 59 (MCP defaults from env).' },
+      },
+      required: ['name', 'query'],
+    },
+    note: 'MCP defaults notify_for_fields and ApiVersion.',
+  },
+
+  graphql_query: {
+    method: 'POST',
+    path: '',
+    urlKind: 'graphql',
+    bodyExplicit: { query: '{query}', variables: '{variables}' },
+  },
+  graphql_query_accounts_with_contacts: {
+    method: 'POST',
+    path: '',
+    urlKind: 'graphql',
+    bodyLiteral: {
+      query: `query accountsWithContacts {
+  uiapi {
+    query {
+      Account {
+        edges {
+          node {
+            Id
+            Name { value }
+            Contacts {
+              edges {
+                node {
+                  Id
+                  Name { value }
+                  Email { value }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}`,
+    },
+    inputSchemaOverride: { type: 'object', properties: {}, required: [] },
+  },
+
+  get_product_catalog: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema('SOQL for PricebookEntry rows (MCP resolves Standard Price Book).'),
+    note: 'MCP resolves pricebook and active filters; via HTTP pass full SOQL as q.',
+  },
+  create_order_from_opportunity: {
+    method: 'POST',
+    path: '/sobjects/Order',
+    urlKind: 'versioned',
+    bodyExplicit: {
+      AccountId: '{account_id}',
+      OpportunityId: '{opportunity_id}',
+      Pricebook2Id: '{pricebook_id}',
+      EffectiveDate: '{effective_date}',
+      Status: 'Draft',
+    },
+    inputSchemaOverride: {
+      type: 'object',
+      properties: {
+        account_id: { type: 'string' },
+        opportunity_id: { type: 'string' },
+        pricebook_id: { type: 'string' },
+        effective_date: { type: 'string' },
+      },
+      required: ['account_id', 'opportunity_id', 'pricebook_id', 'effective_date'],
+    },
+    note: 'MCP also creates OrderItems from opportunity lines; HTTP is Order header only.',
+  },
+  get_subscription_status: {
+    method: 'GET',
+    path: '/query/',
+    urlKind: 'versioned',
+    queryParamsExplicit: { q: '{q}' },
+    inputSchemaOverride: soqlQSchema(
+      'SOQL on Order + OrderItems for an Account (MCP builds AccountId filter).'
+    ),
+    note: 'Pass full SOQL as q.',
+  },
+};
+
+function soqlQSchema(desc) {
+  return {
+    type: 'object',
+    properties: {
+      q: { type: 'string', description: desc },
+    },
+    required: ['q'],
+  };
+}