Home / Directory / Apollo GraphOS / GetProposals
GetProposals
An MCP tool from the Apollo GraphOS server, run by Apollo.
List the schema proposals on a graph: each proposal's ID, title, status (DRAFT, OPEN, APPROVED, IMPLEMENTED, CLOSED), timestamps, author, the source variant it proposes changes to, and the proposal variant that holds its changes, plus the total count for the filter. A schema proposal is a reviewable set of schema changes that GraphOS stores on its own variant. Pass a proposal's id to GetProposal for its revisions and reviews. Provide the graph ID. Optionally filter by status, source variant names, or subgraph names, and page with limit and offset.
Name on the gateway: apollo_graphos__GetProposals.
Parameters
| Name | Type | Description |
|---|---|---|
graphId required | string | |
status | mixed | |
sourceVariants | mixed | |
subgraphs | mixed | |
limit | mixed | |
offset | mixed |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "apollo_graphos__GetProposals",
"arguments": {
"graphId": "…"
}
}The first call connects Apollo GraphOS to your account automatically; nothing to set up. About this server.
Try asking
Use the getproposals tool with graphId set to ….