{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","name":"io.github.Pushary/pushary","title":"Pushary: human-in-the-loop for AI agents","description":"Human-in-the-loop for AI agents: ask a person and get approvals or answers by push notification.","version":"1.5.2","websiteUrl":"https://pushary.com","documentationUrl":"https://pushary.com/docs/agents/quickstart","repository":{"url":"https://github.com/Pushary/pushary-skill","source":"github"},"remotes":[{"type":"streamable-http","url":"https://pushary.com/api/mcp/mcp","headers":[{"name":"Authorization","description":"Bearer <Pushary API key> (format pk_xxx.xxx, from pushary.com)","isRequired":true,"isSecret":true}]},{"type":"sse","url":"https://pushary.com/api/mcp/sse","headers":[{"name":"Authorization","description":"Bearer <Pushary API key> (format pk_xxx.xxx, from pushary.com)","isRequired":true,"isSecret":true}]}],"capabilities":{"tools":true,"resources":true,"prompts":false},"instructions":"Honor authorization already granted by the user and the host permission policy. Use ask_user only for an unresolved decision or missing input; a multi-step task alone needs no extra approval. When the app you run in also has its own question tool, use ask_user instead if the user asked to be reached on another device or through Pushary, said they are stepping away, or the work is long-running or unattended. Ask once on one channel. Follow handoffAction when present, otherwise nextAction; silence is never consent. A poll ending does not expire a question. While pending, keep waiting with the same correlationId; never cancel merely because no answer arrived during a poll. Cancel a live question before moving it to the current client. If cancellation returns handoffAction \"stop\", stop. Otherwise, if cancellation returns false, poll once for 1 second and honor the answer that won the race. Use send_notification for a requested update or a meaningful unattended result, such as a finished task, not duplicate reports. Ask questions with ask_user, not with send_notification context.askQuestion. A question asked through a connector, by signing in or with a connector key, closes 10 minutes after it is sent; one asked with any other key stays open until answered or cancelled. If you would take your default without asking at all, do not ask: take it and list that decision in your final message. This never covers an irreversible step, a deploy or publish, anything sent outside the team, spending money or a decision outside your authority that the user has not already approved: those still need a question before you act; after a Pushary hook approved that exact tool use, do not ask about it again. Running the same command later is a new step. When the requested work is complete, report it and stop: do not ask what to do next or offer more work, through ask_user or context.askQuestion, unless the user asked you to. Work blocked on a choice only the user can make is not complete; ask that choice. Pass agentName as the actual host and task. Pushary skills guide use; tools do not override host approvals.","authentication":{"apiKey":{"scheme":"bearer","header":"Authorization","format":"pk_xxx.xxx","documentation":"https://pushary.com/docs/agents/api-key"},"oauth2":{"protectedResourceMetadata":"https://pushary.com/.well-known/oauth-protected-resource/api/mcp/mcp","authorizationServerMetadata":"https://pushary.com/.well-known/oauth-authorization-server"}},"resources":[{"uri":"https://pushary.com/llms.txt","name":"site-index","title":"Pushary site index (llms.txt)","description":"What Pushary is, what it is not, the questions it answers, and a linked map of every page on pushary.com. Start here.","mimeType":"text/markdown"},{"uri":"https://pushary.com/llms-full.txt","name":"documentation","title":"Pushary documentation (full corpus)","description":"Every Pushary documentation page concatenated into one Markdown file: quickstart, API keys, per-agent setup guides, permission policies, the audit trail, and the embed integration guide.","mimeType":"text/markdown"},{"uri":"https://pushary.com/openapi.json","name":"openapi","title":"Pushary REST API (OpenAPI 3.1)","description":"The full REST surface: decisions, authorization, end-user enrollment, per-end-user keys, notifications, subscribers, campaigns, templates and flows. Typed schemas and a unique operationId per operation.","mimeType":"application/json"},{"uri":"https://pushary.com/docs/agents/quickstart.md","name":"quickstart","title":"Quickstart: connect an agent to Pushary","description":"The one-command setup that wires the MCP server, permission hooks and event tracking into an agent, and what to check when it does not connect.","mimeType":"text/markdown"},{"uri":"https://pushary.com/docs/agents/reference/tools.md","name":"tool-reference","title":"Pushary MCP tool reference","description":"What every tool on this server does, what it takes, and what it returns: ask_user, wait_for_answer, send_notification, cancel_question, and the Partner decision tools.","mimeType":"text/markdown"}]}