Flat MCP connector
Flat is a collaborative music notation platform for creating, editing, and sharing sheet music with students and teams. The Flat MCP connector allows AI agents to manage classes and assignments, enroll students, and organize educational content within music classrooms. It also supports accessing user scores, updating class settings, and archiving or activating class sessions.
Authentication type
- OAuth 2.0 Authorization Code - Requires a one-time user login to authorize the agent to access the service on their behalf.
Uses
Use the Flat MCP connector to perform the following actions:
- Create and manage music classes with automated student enrollment and archival workflows
- Assign music notation projects to students and track completion across your institution
- Collect and grade student music submissions with built-in feedback and commenting tools
- Export student grades to CSV or Excel for reporting and transcript integration
- Organize music resources into collections for curriculum alignment and course delivery
- Automate submission feedback loops by adding and updating comments on student work
- Remove or add users to classes programmatically to match roster changes in real time
Example prompts
Use the following example prompts to invoke Flat MCP connector tools from your AI assistant or Boomi Connect workflow:
Show me all active classes in Flat for the current user.Create a new music theory class in Flat and add 15 students to it.List all assignments for my composition course in Flat.Export student grades from Flat as an Excel file for this semester.Add feedback comments to all incomplete submissions in Flat for assignment 5.Archive the introductory ear training class in Flat.Show me which students haven't submitted their final project in Flat.Copy last semester's assignment template to this semester in Flat.Remove a student from the advanced orchestration class in Flat.Create a new collection in Flat for contemporary music resources.
Flat MCP connector tools
The Flat MCP connector provides the following tools. Each tool maps to a specific action you can invoke from your AI agent or automation.
| Tool | Description |
|---|---|
| listClasses | Retrieves all classes available to the current user. |
| createClass | Creates a new class with specified details. |
| enrollClass | Enrolls the current user in a class. |
| getClass | Retrieves detailed information about a specific class. |
| updateClass | Modifies settings and information for an existing class. |
| activateClass | Enables a class for active use. |
| unarchiveClass | Restores a previously archived class to active status. |
| archiveClass | Archives a class to remove it from active view. |
| listAssignments | Retrieves all assignments for a class. |
| createAssignment | Creates a new assignment within a class. |
| unarchiveAssignment | Restores a previously archived assignment to active status. |
| archiveAssignment | Archives an assignment to remove it from active view. |
| copyAssignment | Duplicates an existing assignment with its settings. |
| getSubmissions | Retrieves all student submissions for an assignment. |
| createSubmission | Creates or updates a student submission for an assignment. |
| exportSubmissionsReviewsAsCsv | Exports grades and feedback as a CSV file. |
| exportSubmissionsReviewsAsExcel | Exports grades and feedback as an Excel file. |
| deleteSubmission | Removes a student submission from the system. |
| getSubmission | Retrieves a specific student submission. |
| editSubmission | Modifies an existing student submission. |
| getSubmissionComments | Retrieves all feedback comments on a submission. |
| postSubmissionComment | Adds a feedback comment to a submission. |
| deleteSubmissionComment | Removes a feedback comment from a submission. |
| updateSubmissionComment | Modifies an existing feedback comment on a submission. |
| getSubmissionHistory | Retrieves version history and changes for a submission. |
| listClassStudentSubmissions | Retrieves all submissions from a specific student. |
| deleteClassUser | Removes a user from a class. |
| addClassUser | Adds a user to a class. |
| listCollections | Retrieves all collections available. |
| createCollection | Creates a new collection with specified settings. |
| deleteCollection | Delete the collection. |
| getCollection | Get collection details. |
| editCollection | Update a collection's metadata. |
| listCollectionScores | List the scores contained in a collection. |
| deleteScoreFromCollection | Delete a score from the collection. |
| addScoreToCollection | Add a score to the collection. |
| untrashCollection | Untrash a collection. |
| getGroupDetails | Get group information. |
| getGroupScores | List group's scores. |
| listGroupUsers | List group's users. |
| getAuthenticatedUser | Get current user profile. |
| listOrganizationInvitations | List the organization invitations. |
| createOrganizationInvitation | Create a new invitation to join the organization. |
| removeOrganizationInvitation | Remove an organization invitation. |
| listLtiCredentials | List LTI 1.x credentials. |
| createLtiCredentials | Create a new couple of LTI 1.x credentials. |
| revokeLtiCredentials | Revoke LTI 1.x credentials. |
| listOrganizationUsers | List the organization users. |
| createOrganizationUser | Create a new user account. |
| countOrgaUsers | Count the organization users using the provided filters. |
| removeOrganizationUser | Remove an account from Flat. |
| updateOrganizationUser | Update account information. |
| createScore | Create a new score. |
| deleteScore | Delete a score. |
| getScore | Get a score's metadata. |
| editScore | Edit a score's metadata. |
| getScoreCollaborators | List the collaborators. |
| addScoreCollaborator | Add a new collaborator. |
| removeScoreCollaborator | Delete a collaborator. |
| getScoreCollaborator | Get a collaborator. |
| getScoreComments | List comments. |
| postScoreComment | Post a new comment. |
| deleteScoreComment | Delete a comment. |
| updateScoreComment | Update an existing comment. |
| markScoreCommentUnresolved | Mark the comment as unresolved. |
| markScoreCommentResolved | Mark the comment as resolved. |
| forkScore | Fork a score. |
| getScoreRevisions | List the revisions. |
| createScoreRevision | Create a new revision. |
| getScoreRevision | Get a score revision. |
| getScoreRevisionData | Get a score revision data. |
| getScoreSubmissions | List submissions related to the score. |
| listScoreTracks | List the audio or video tracks linked to a score. |
| addScoreTrack | Add a new video or audio track to the score. |
| deleteScoreTrack | Remove an audio or video track linked to the score. |
| getScoreTrack | Retrieve the details of an audio or video track linked to a score. |
| updateScoreTrack | Update an audio or video track linked to a score. |
| untrashScore | Untrash a score. |
| getUser | Get a public user profile. |
| gerUserLikes | List liked scores. |
| getUserScores | List user's scores. |
