Flat MCP connector
Updated
Flat is a music notation platform for creating, collaborating on, and teaching sheet music online. The Flat MCP connector allows AI agents to manage classes by creating, updating, joining, activating, and archiving them for students and educators. It also supports handling assignments, giving AI agents broader control over music education workflows within a Flat tenant.
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:
- Organize classes and track student rosters across music education programs
- Automate assignment creation and distribution to students in Flat
- Track student submissions and grade progress on notation assignments
- Export grades to CSV or Excel for reporting and record-keeping
- Streamline feedback delivery with comments on student submissions
- Manage class membership by adding or removing students and teachers
- Organize sheet music into collections for easy access and sharing
- Archive or reactivate classes and assignments to keep workflows current
Example prompts
Use the following example prompts to invoke Flat MCP connector tools from your AI assistant or Boomi Connect workflow:
Show me all the classes I have access to in Flat.Create a new class called Advanced Theory in Flat.List all assignments due this week in Flat.Export grades for my music theory class as an Excel file.Show me the submissions from Emma for the latest assignment.Add a feedback comment to Jake's submission in Flat.Archive the assignment we finished last semester.Add a new student to my beginner piano class.List all collections of sheet music available in Flat.Get the details of my intermediate guitar class.
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 | List the classes available for the current user |
| createClass | Create a new class |
| enrollClass | Join a class |
| getClass | Get the details of a single class |
| updateClass | Update the class |
| activateClass | Activate the class |
| unarchiveClass | Unarchive the class |
| archiveClass | Archive the class |
| listAssignments | Assignments listing |
| createAssignment | Assignment creation |
| unarchiveAssignment | Unarchive the assignment. |
| archiveAssignment | Archive the assignment |
| copyAssignment | Copy an assignment |
| getSubmissions | List the students' submissions |
| createSubmission | Create or edit a submission |
| exportSubmissionsReviewsAsCsv | CSV Grades exports |
| exportSubmissionsReviewsAsExcel | Excel Grades exports |
| deleteSubmission | Delete a submission |
| getSubmission | Get a student submission |
| editSubmission | Edit a submission |
| getSubmissionComments | List the feedback comments of a submission |
| postSubmissionComment | Add a feedback comment to a submission |
| deleteSubmissionComment | Delete a feedback comment to a submission |
| updateSubmissionComment | Update a feedback comment to a submission |
| getSubmissionHistory | Get the history of the submission |
| listClassStudentSubmissions | List the submissions for a student |
| deleteClassUser | Remove a user from the class |
| addClassUser | Add a user to the class |
| listCollections | List the collections |
| createCollection | Create a new collection |
| 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 |
