Salesforce MCP has 10 tools with basic schemas and descriptions, but significant quality gaps. Tool names follow verb_noun convention (good), but descriptions are inconsistent, some are detailed (create_tab: 127 chars), others minimal (run_soql_query: 47 chars). Parameter descriptions exist but lack actionable constraints (e.g., 'query' param has no format guidance). Array schemas use 'properties' instead of 'items', violating JSON Schema. No output schemas documented. Error handling is absent, no recovery guidance or categorization. No tool annotations (readOnlyHint, destructiveHint). Security: no evidence of secret injection or permission gates. Composition is reasonable (10 focused tools), but missing idempotency guarantees and pagination for list operations.

• Fix array schemas: replace 'properties' with 'items' and 'type: object' for create_object.fields and delete_object_fields.fields. Example: {"type": "array", "items": {"type": "object", "properties": {...}}}
• Document output schemas for all tools. Specify returned fields, types, and examples. E.g., create_record returns {"id": "string", "success": "boolean", "errors": "array"}.
• Add tool annotations: mark run_soql_query and run_sosl_search with readOnlyHint=true; mark delete_object_fields and delete_record with destructiveHint=true.
• Enhance query/search parameter descriptions with syntax examples and constraints. E.g., 'SOQL query (SELECT ... FROM ... WHERE ...). Valid fields depend on object schema. Call get_object_fields first if unsure.'
• Implement structured error responses with categorization: {"error": "...", "category": "retryable|user_fixable|fatal", "suggestion": "..."}. Guide agents on next steps.