Royalties MCP Server

The Royalties MCP Server allows AI assistants to view and manage your accounting operations, including executing royalty runs, retrieving contracts, managing payee statements, and checking sales reports.

Authentication

Use your existing Revelator Partner API credentials (partnerUserId and partnerApiKey) when your LLM prompts you to do so. This is usually only required initially when starting a new chat/session.

Server Details

• Server Address: https://mcp.revelator.com/royalties

Supported Tools

Tool Name	Description
Contracts_GetContract	Retrieves details for a specific royalty contract.
Contracts_UpdateContractStatus	Updates the active/inactive status of a contract.
Contracts_GetAllContracts	Retrieves a list of all configured royalty contracts.
Contracts_UpdateContract	Modifies the terms or details of an existing contract.
Contracts_CreateContract	Creates a new royalty contract.
Contracts_GetAssetContractsStatuses	Checks the contract assignment status for a specific release asset.
PayeeStatements_GetAllPayeeStatements	Retrieves a list of generated statements for payees.
PayeeStatements_GetPayeeStatement	Retrieves detailed information for a specific payee statement.
PayeeStatements_ByTransactionReferenceCode	Retrieves analytics for a statement based on specific transaction lines.
PayeeStatements_DownloadPayeeStatementInfo	Generates a download link for a payee statement report.
PayeeStatements_DeletePayeeStatements	Deletes one or more payee statements.
PayeeStatements_UnapprovePayeeStatements	Reverts approved payee statements back to an unapproved state.
PayeeStatements_ApprovePayeeStatements	Marks payee statements as approved and ready for payment.
RoyaltyRuns_GetAllRoyaltyRuns	Retrieves a history of previous royalty calculation runs.
RoyaltyRuns_CreateRoyaltyRun	Initiates a new royalty calculation run for a specific period.
RoyaltyRuns_GetRoyaltyRun	Retrieves the status and details of a specific royalty run.
RoyaltyRuns_DeleteQueue	Cancels or deletes a queued royalty run.
RoyaltyRuns_ResetQueue	Retries or resets a failed royalty run in the queue.
SalesReports_GetAllSalesReports	Retrieves a list of ingested DSP sales reports.
SalesReports_GetSaleReport	Retrieves details of a specific ingested sales report.
SalesReports_SetTaxAndFx	Updates tax deductions or foreign exchange rates on a specific sales report.
SalesReports_GetSalesReportsStatuses	Retrieves the processing statuses of uploaded sales reports.
SalesReports_DownloadReport	Generates a download link for a raw sales report file.
SalesReports_SetAdjustment	Applies a manual financial adjustment to a sales report.
SalesReports_DeleteSalesReports	Deletes one or more sales reports from the system.
SalesReports_ApproveSalesReports	Approves ingested sales reports for inclusion in the next royalty run.
SalesReports_UnapproveSalesReports	Unapproves sales reports, removing them from calculation eligibility.